@graftland/cli 0.0.0-stage → 0.2.0-beta.0

package/dist/internal/env.js

@@ -0,0 +1,50 @@
+import { Cause, ConfigProvider, Context, Deferred, Effect, Exit, FileSystem, Layer, Path, Queue, Ref, Stream } from "effect";
+// src/internal/env.ts
+const options = { preserveEmptyStrings: true };
+var EnvFile = class extends Context.Service()("@graftland/cli/internal/env/EnvFile") {};
+/** Provides `ConfigProvider` and `EnvFile`; a missing file fails the layer. */
+const layer = (file) => Layer.unwrap(Effect.gen(function* () {
+	const environment = ConfigProvider.fromEnv(options);
+	if (file === void 0) return Layer.merge(ConfigProvider.layer(environment), Layer.succeed(EnvFile, { reload: Effect.succeed(false) }));
+	const fs = yield* FileSystem.FileSystem;
+	const read = Effect.gen(function* () {
+		const target = yield* fs.realPath(file);
+		const text = yield* fs.readFileString(target);
+		return {
+			target,
+			text,
+			provider: ConfigProvider.fromDotEnvContents(text, options)
+		};
+	});
+	const initial = yield* read;
+	const loaded = yield* Ref.make(initial);
+	const fromFile = ConfigProvider.make((path) => Effect.flatMap(Ref.get(loaded), ({ provider }) => provider.load(path)));
+	return Layer.merge(ConfigProvider.layer(ConfigProvider.orElse(environment, fromFile)), Layer.succeed(EnvFile, { reload: Effect.gen(function* () {
+		const next = yield* read;
+		const previous = yield* Ref.getAndSet(loaded, next);
+		return next.text !== previous.text;
+	}) }));
+}));
+/**
+* The handlers below let interruption through, and with it any failure raised
+* while stopping. Log those; failures without interruption are handled there.
+*/
+const logStopped = (file) => (exit) => Exit.isFailure(exit) && Cause.hasInterrupts(exit.cause) && (Cause.hasFails(exit.cause) || Cause.hasDies(exit.cause)) ? Effect.logError(`Watching ${file} stopped with a failure`, exit.cause) : Effect.void;
+/**
+* Reloads the file when it changes and retries the loader's entries, which
+* reads `!env` again. A file that cannot be read keeps its previous values.
+*/
+const watchEnvFile = (file, reload, retry) => Effect.gen(function* () {
+	const fs = yield* FileSystem.FileSystem;
+	const path = yield* Path.Path;
+	const ready = yield* Deferred.make();
+	const events = Stream.callback((queue) => fs.watch(path.dirname(file), { onReady: () => Deferred.doneUnsafe(ready, Effect.void) }).pipe(Stream.filter((event) => path.basename(event.path) === path.basename(file)), Stream.runForEachArray((events) => Queue.offerAll(queue, events)), Effect.scoped, Effect.onExit(logStopped(file)), Effect.catchCauseIf((cause) => !Cause.hasInterrupts(cause), (cause) => Effect.logError(`Watching ${file} failed`, cause)), Effect.andThen(Effect.sleep("1 second")), Effect.forever), { bufferSize: 16 });
+	yield* Stream.mergeAll([
+		Stream.as(events, void 0),
+		Stream.fromEffect(Deferred.await(ready)),
+		Stream.tick("1 second").pipe(Stream.drop(1))
+	], { concurrency: "unbounded" }).pipe(Stream.runForEach(() => Effect.sleep("100 millis").pipe(Effect.andThen(reload), Effect.flatMap((changed) => changed ? retry : Effect.void), Effect.catchCauseIf((cause) => !Cause.hasInterrupts(cause), (cause) => Effect.logError(`Reloading ${file} failed`, cause)))), Effect.catchCauseIf((cause) => !Cause.hasInterrupts(cause), (cause) => Effect.logError(`Stopped watching ${file}`, cause)));
+}).pipe(Effect.onExit(logStopped(file)));
+export { EnvFile, layer, watchEnvFile };
+
+//# sourceMappingURL=env.js.map

package/dist/internal/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","names":[],"sources":["../../src/internal/env.ts"],"sourcesContent":["/**\n * Where `!env` values come from: the process environment, then an optional\n * `.env` file that watch mode reads again when it changes.\n */\nimport type { PlatformError } from \"effect\"\nimport {\n\tCause,\n\tConfigProvider,\n\tContext,\n\tDeferred,\n\tEffect,\n\tExit,\n\tFileSystem,\n\tLayer,\n\tPath,\n\tQueue,\n\tRef,\n\tStream,\n} from \"effect\"\n\n// An empty variable is still set: it overrides the file, and the plugin's\n// schema decides whether it is valid.\nconst options = { preserveEmptyStrings: true } as const\n\ninterface Loaded {\n\treadonly target: string\n\treadonly text: string\n\treadonly provider: ConfigProvider.ConfigProvider\n}\n\nexport class EnvFile extends Context.Service<\n\tEnvFile,\n\t{\n\t\t/** Reads the file again; reports whether its contents changed. */\n\t\treadonly reload: Effect.Effect<boolean, PlatformError.PlatformError>\n\t}\n>()(\"@graftland/cli/internal/env/EnvFile\") {}\n\n/** Provides `ConfigProvider` and `EnvFile`; a missing file fails the layer. */\nexport const layer = (file: string | undefined) =>\n\tLayer.unwrap(\n\t\tEffect.gen(function* () {\n\t\t\tconst environment = ConfigProvider.fromEnv(options)\n\t\t\tif (file === undefined)\n\t\t\t\treturn Layer.merge(\n\t\t\t\t\tConfigProvider.layer(environment),\n\t\t\t\t\tLayer.succeed(EnvFile, { reload: Effect.succeed(false) }),\n\t\t\t\t)\n\t\t\tconst fs = yield* FileSystem.FileSystem\n\t\t\t// Resolve the request on every read, including polling. Never pin a\n\t\t\t// symlink to its initial target. The provider and its baseline are\n\t\t\t// committed together from the bytes actually read.\n\t\t\tconst read = Effect.gen(function* () {\n\t\t\t\tconst target = yield* fs.realPath(file)\n\t\t\t\tconst text = yield* fs.readFileString(target)\n\t\t\t\treturn {\n\t\t\t\t\ttarget,\n\t\t\t\t\ttext,\n\t\t\t\t\tprovider: ConfigProvider.fromDotEnvContents(text, options),\n\t\t\t\t}\n\t\t\t})\n\t\t\tconst initial: Loaded = yield* read\n\t\t\tconst loaded = yield* Ref.make(initial)\n\t\t\tconst fromFile = ConfigProvider.make((path) =>\n\t\t\t\tEffect.flatMap(Ref.get(loaded), ({ provider }) => provider.load(path)),\n\t\t\t)\n\t\t\treturn Layer.merge(\n\t\t\t\tConfigProvider.layer(ConfigProvider.orElse(environment, fromFile)),\n\t\t\t\tLayer.succeed(EnvFile, {\n\t\t\t\t\treload: Effect.gen(function* () {\n\t\t\t\t\t\tconst next = yield* read\n\t\t\t\t\t\tconst previous = yield* Ref.getAndSet(loaded, next)\n\t\t\t\t\t\treturn next.text !== previous.text\n\t\t\t\t\t}),\n\t\t\t\t}),\n\t\t\t)\n\t\t}),\n\t)\n\n/**\n * The handlers below let interruption through, and with it any failure raised\n * while stopping. Log those; failures without interruption are handled there.\n */\nconst logStopped =\n\t(file: string) =>\n\t<A, E>(exit: Exit.Exit<A, E>) =>\n\t\tExit.isFailure(exit) &&\n\t\tCause.hasInterrupts(exit.cause) &&\n\t\t(Cause.hasFails(exit.cause) || Cause.hasDies(exit.cause))\n\t\t\t? Effect.logError(`Watching ${file} stopped with a failure`, exit.cause)\n\t\t\t: Effect.void\n\n/**\n * Reloads the file when it changes and retries the loader's entries, which\n * reads `!env` again. A file that cannot be read keeps its previous values.\n */\nexport const watchEnvFile = <E, R>(\n\tfile: string,\n\treload: Effect.Effect<boolean, PlatformError.PlatformError>,\n\tretry: Effect.Effect<void, E, R>,\n) =>\n\tEffect.gen(function* () {\n\t\tconst fs = yield* FileSystem.FileSystem\n\t\tconst path = yield* Path.Path\n\t\tconst ready = yield* Deferred.make<void>()\n\t\t// As in HMR, own the source scope inside the producer. Observe its\n\t\t// complete Exit after cleanup, before merge can discard it.\n\t\tconst events = Stream.callback<\n\t\t\tFileSystem.WatchEvent,\n\t\t\tPlatformError.PlatformError\n\t\t>(\n\t\t\t(queue) =>\n\t\t\t\tfs\n\t\t\t\t\t.watch(path.dirname(file), {\n\t\t\t\t\t\tonReady: () => Deferred.doneUnsafe(ready, Effect.void),\n\t\t\t\t\t})\n\t\t\t\t\t.pipe(\n\t\t\t\t\t\tStream.filter(\n\t\t\t\t\t\t\t(event) => path.basename(event.path) === path.basename(file),\n\t\t\t\t\t\t),\n\t\t\t\t\t\tStream.runForEachArray((events) => Queue.offerAll(queue, events)),\n\t\t\t\t\t\tEffect.scoped,\n\t\t\t\t\t\tEffect.onExit(logStopped(file)),\n\t\t\t\t\t\tEffect.catchCauseIf(\n\t\t\t\t\t\t\t(cause) => !Cause.hasInterrupts(cause),\n\t\t\t\t\t\t\t(cause) => Effect.logError(`Watching ${file} failed`, cause),\n\t\t\t\t\t\t),\n\t\t\t\t\t\t// A failed native backend must not stop content reconciliation.\n\t\t\t\t\t\tEffect.andThen(Effect.sleep(\"1 second\")),\n\t\t\t\t\t\tEffect.forever,\n\t\t\t\t\t),\n\t\t\t{ bufferSize: 16 },\n\t\t)\n\t\t// Native events accelerate updates. Poll the request too: its target\n\t\t// may live outside this directory, change, or lose a notification.\n\t\tyield* Stream.mergeAll(\n\t\t\t[\n\t\t\t\tStream.as(events, undefined),\n\t\t\t\tStream.fromEffect(Deferred.await(ready)),\n\t\t\t\tStream.tick(\"1 second\").pipe(Stream.drop(1)),\n\t\t\t],\n\t\t\t{ concurrency: \"unbounded\" },\n\t\t).pipe(\n\t\t\tStream.runForEach(() =>\n\t\t\t\t// Delay to let writes settle.\n\t\t\t\tEffect.sleep(\"100 millis\").pipe(\n\t\t\t\t\tEffect.andThen(reload),\n\t\t\t\t\tEffect.flatMap((changed) => (changed ? retry : Effect.void)),\n\t\t\t\t\tEffect.catchCauseIf(\n\t\t\t\t\t\t(cause) => !Cause.hasInterrupts(cause),\n\t\t\t\t\t\t(cause) => Effect.logError(`Reloading ${file} failed`, cause),\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t),\n\t\t\tEffect.catchCauseIf(\n\t\t\t\t(cause) => !Cause.hasInterrupts(cause),\n\t\t\t\t(cause) => Effect.logError(`Stopped watching ${file}`, cause),\n\t\t\t),\n\t\t)\n\t}).pipe(\n\t\t// Observe the whole watcher before forkScoped owns it.\n\t\tEffect.onExit(logStopped(file)),\n\t)\n"],"mappings":"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"}

package/dist/internal/intercepts.js

@@ -0,0 +1,12 @@
+import { LogLevel, References, Schema } from "effect";
+import { Intercept } from "@graftland/loader";
+// src/internal/intercepts.ts
+/** References that can be configured by stock CLI entries. */
+const registrations = [Intercept.make(References.CurrentLogAnnotations, Schema.Record(Schema.String, Schema.Unknown).annotate({ description: "Shallowly merges with outer annotations; configured keys win." }), (outer, patch) => ({
+	...outer,
+	...patch
+})), Intercept.make(References.MinimumLogLevel, Schema.Literals(LogLevel.values).annotate({ description: "Replaces the outer minimum log level." }), (_, level) => level)];
+const layer = Intercept.layer(registrations);
+export { layer, registrations };
+
+//# sourceMappingURL=intercepts.js.map

package/dist/internal/intercepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intercepts.js","names":[],"sources":["../../src/internal/intercepts.ts"],"sourcesContent":["import { Intercept } from \"@graftland/loader\"\nimport { LogLevel, References, Schema } from \"effect\"\n\n/** References that can be configured by stock CLI entries. */\nexport const registrations = [\n\tIntercept.make(\n\t\tReferences.CurrentLogAnnotations,\n\t\tSchema.Record(Schema.String, Schema.Unknown).annotate({\n\t\t\tdescription:\n\t\t\t\t\"Shallowly merges with outer annotations; configured keys win.\",\n\t\t}),\n\t\t(outer, patch) => ({ ...outer, ...patch }),\n\t),\n\tIntercept.make(\n\t\tReferences.MinimumLogLevel,\n\t\tSchema.Literals(LogLevel.values).annotate({\n\t\t\tdescription: \"Replaces the outer minimum log level.\",\n\t\t}),\n\t\t(_, level) => level,\n\t),\n]\n\nexport const layer = Intercept.layer(registrations)\n"],"mappings":";;;;AAIA,MAAa,gBAAgB,CAC5B,UAAU,KACT,WAAW,uBACX,OAAO,OAAO,OAAO,QAAQ,OAAO,OAAO,CAAC,CAAC,SAAS,EACrD,aACC,gEACF,CAAC,IACA,OAAO,WAAW;CAAE,GAAG;CAAO,GAAG;AAAM,EACzC,GACA,UAAU,KACT,WAAW,iBACX,OAAO,SAAS,SAAS,MAAM,CAAC,CAAC,SAAS,EACzC,aAAa,wCACd,CAAC,IACA,GAAG,UAAU,KACf,CACD;AAEA,MAAa,QAAQ,UAAU,MAAM,aAAa"}

package/dist/internal/watch.js

@@ -0,0 +1,25 @@
+import { Array, Cause, Effect, Exit, Stream, String } from "effect";
+// src/internal/watch.ts
+const moduleExtensions = [
+	".js",
+	".mjs",
+	".cjs",
+	".ts",
+	".mts",
+	".cts"
+];
+/** Whether a change to this file should reload plugin modules. */
+const isModule = (path) => !Array.contains(String.split(/[/\\]/)(path), "node_modules") && Array.some(moduleExtensions, (extension) => String.endsWith(extension)(path));
+const describe = (result) => result._tag === "Reloaded" ? Effect.logInfo(`Reloaded ${result.entries.length} plugin module(s)`) : Effect.logWarning(result.reason === "ambiguous-exports" ? `Restart required: shared plugin exports diverged in ${Array.join(result.modules, ", ")}` : result.reason === "identity-conflict" ? `Restart required: plugin replacement identities conflict in ${Array.join(result.modules, ", ")}` : `Restart required to pick up ${Array.join(result.modules, ", ")}`);
+/** Owns the HMR stream and retries failed loader entries after each reload. */
+const watchModules = (hmr, directory, retry) => hmr.watch([directory], {
+	recursive: true,
+	filter: isModule
+}).pipe(Stream.runForEach((result) => Effect.gen(function* () {
+	if (result._tag === "Failed") return yield* Effect.failCause(result.cause);
+	yield* describe(result);
+	yield* retry;
+}).pipe(Effect.catchCauseIf((cause) => !Cause.hasInterrupts(cause), (cause) => Effect.logError("Reloading plugin modules failed", cause)))), Effect.catchCauseIf((cause) => !Cause.hasInterrupts(cause), (cause) => Effect.logError("Watching plugin modules failed", cause)), Effect.andThen(Effect.sleep("1 second")), Effect.forever, Effect.onExit((exit) => Exit.isFailure(exit) && (Cause.hasFails(exit.cause) || Cause.hasDies(exit.cause)) ? Effect.logError("Module watcher exited with a failure", exit.cause) : Effect.void));
+export { isModule, watchModules };
+
+//# sourceMappingURL=watch.js.map

package/dist/internal/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","names":[],"sources":["../../src/internal/watch.ts"],"sourcesContent":["import type * as Hmr from \"@graftland/hmr\"\nimport { Array, Cause, Effect, Exit, Stream, String } from \"effect\"\n\nconst moduleExtensions = [\".js\", \".mjs\", \".cjs\", \".ts\", \".mts\", \".cts\"]\n\n/** Whether a change to this file should reload plugin modules. */\nexport const isModule = (path: string) =>\n\t!Array.contains(String.split(/[/\\\\]/)(path), \"node_modules\") &&\n\tArray.some(moduleExtensions, (extension) => String.endsWith(extension)(path))\n\nconst describe = (result: Hmr.ReloadResult) =>\n\tresult._tag === \"Reloaded\"\n\t\t? Effect.logInfo(`Reloaded ${result.entries.length} plugin module(s)`)\n\t\t: Effect.logWarning(\n\t\t\t\tresult.reason === \"ambiguous-exports\"\n\t\t\t\t\t? `Restart required: shared plugin exports diverged in ${Array.join(result.modules, \", \")}`\n\t\t\t\t\t: result.reason === \"identity-conflict\"\n\t\t\t\t\t\t? `Restart required: plugin replacement identities conflict in ${Array.join(result.modules, \", \")}`\n\t\t\t\t\t\t: `Restart required to pick up ${Array.join(result.modules, \", \")}`,\n\t\t\t)\n\n/** Owns the HMR stream and retries failed loader entries after each reload. */\nexport const watchModules = <E, R>(\n\thmr: Pick<Hmr.Hmr, \"watch\">,\n\tdirectory: string,\n\tretry: Effect.Effect<void, E, R>,\n) =>\n\thmr.watch([directory], { recursive: true, filter: isModule }).pipe(\n\t\tStream.runForEach((result) =>\n\t\t\tEffect.gen(function* () {\n\t\t\t\tif (result._tag === \"Failed\")\n\t\t\t\t\treturn yield* Effect.failCause(result.cause)\n\t\t\t\tyield* describe(result)\n\t\t\t\tyield* retry\n\t\t\t}).pipe(\n\t\t\t\tEffect.catchCauseIf(\n\t\t\t\t\t(cause) => !Cause.hasInterrupts(cause),\n\t\t\t\t\t(cause) => Effect.logError(\"Reloading plugin modules failed\", cause),\n\t\t\t\t),\n\t\t\t),\n\t\t),\n\t\tEffect.catchCauseIf(\n\t\t\t(cause) => !Cause.hasInterrupts(cause),\n\t\t\t(cause) => Effect.logError(\"Watching plugin modules failed\", cause),\n\t\t),\n\t\t// A backend failure ends the stream. Reinstall it after a delay rather than\n\t\t// leaving the application running without a watcher.\n\t\tEffect.andThen(Effect.sleep(\"1 second\")),\n\t\tEffect.forever,\n\t\t// onExit runs uninterruptibly, after stream cleanup. Observe the entire\n\t\t// worker before forkScoped owns it, including mixed interruption causes.\n\t\tEffect.onExit((exit) =>\n\t\t\tExit.isFailure(exit) &&\n\t\t\t(Cause.hasFails(exit.cause) || Cause.hasDies(exit.cause))\n\t\t\t\t? Effect.logError(\"Module watcher exited with a failure\", exit.cause)\n\t\t\t\t: Effect.void,\n\t\t),\n\t)\n"],"mappings":";;AAGA,MAAM,mBAAmB;CAAC;CAAO;CAAQ;CAAQ;CAAO;CAAQ;AAAM;;AAGtE,MAAa,YAAY,SACxB,CAAC,MAAM,SAAS,OAAO,MAAM,OAAO,CAAC,CAAC,IAAI,GAAG,cAAc,KAC3D,MAAM,KAAK,mBAAmB,cAAc,OAAO,SAAS,SAAS,CAAC,CAAC,IAAI,CAAC;AAE7E,MAAM,YAAY,WACjB,OAAO,SAAS,aACb,OAAO,QAAQ,YAAY,OAAO,QAAQ,OAAO,kBAAkB,IACnE,OAAO,WACP,OAAO,WAAW,sBACf,uDAAuD,MAAM,KAAK,OAAO,SAAS,IAAI,MACtF,OAAO,WAAW,sBACjB,+DAA+D,MAAM,KAAK,OAAO,SAAS,IAAI,MAC9F,+BAA+B,MAAM,KAAK,OAAO,SAAS,IAAI,GACnE;;AAGH,MAAa,gBACZ,KACA,WACA,UAEA,IAAI,MAAM,CAAC,SAAS,GAAG;CAAE,WAAW;CAAM,QAAQ;AAAS,CAAC,CAAC,CAAC,KAC7D,OAAO,YAAY,WAClB,OAAO,IAAI,aAAa;CACvB,IAAI,OAAO,SAAS,UACnB,OAAO,OAAO,OAAO,UAAU,OAAO,KAAK;CAC5C,OAAO,SAAS,MAAM;CACtB,OAAO;AACR,CAAC,CAAC,CAAC,KACF,OAAO,cACL,UAAU,CAAC,MAAM,cAAc,KAAK,IACpC,UAAU,OAAO,SAAS,mCAAmC,KAAK,CACpE,CACD,CACD,GACA,OAAO,cACL,UAAU,CAAC,MAAM,cAAc,KAAK,IACpC,UAAU,OAAO,SAAS,kCAAkC,KAAK,CACnE,GAGA,OAAO,QAAQ,OAAO,MAAM,UAAU,CAAC,GACvC,OAAO,SAGP,OAAO,QAAQ,SACd,KAAK,UAAU,IAAI,MAClB,MAAM,SAAS,KAAK,KAAK,KAAK,MAAM,QAAQ,KAAK,KAAK,KACpD,OAAO,SAAS,wCAAwC,KAAK,KAAK,IAClE,OAAO,IACX,CACD"}

package/dist/package.js

@@ -0,0 +1,5 @@
+// package.json
+var version = "0.0.0";
+export { version };
+
+//# sourceMappingURL=package.js.map

package/dist/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@graftland/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0-beta.0",
+  "type": "module",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "description": "The graft command: start, create, add and remove",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/graftland/graft.git",
+    "directory": "packages/cli"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src",
+    "schema.json",
+    "README.zh-CN.md",
+    "README.zh-TW.md"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./bin": "./dist/bin.js",
+    "./internal/configSchema": "./dist/internal/configSchema.js",
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "effect": "4.1.*"
+  },
+  "devDependencies": {
+    "@effect/vitest": "4.1.2",
+    "effect": "4.1.2",
+    "vitest": "5.1.0"
+  },
+  "dependencies": {
+    "@graftland/graft": "0.2.0-beta.0",
+    "@graftland/loader": "0.2.0-beta.0",
+    "@graftland/hmr": "0.2.0-beta.0",
+    "@graftland/create": "0.2.0-beta.0",
+    "@graftland/package-manager": "0.2.0-beta.0",
+    "@effect/platform-node": "4.1.2"
+  },
+  "bin": {
+    "graft": "./dist/bin.js"
+  },
+  "scripts": {
+    "build": "tsdown && node scripts/schema.mjs",
+    "test": "vitest run"
+  }
 }

package/schema.json

@@ -0,0 +1,178 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"anyOf": [
+		{
+			"type": "array",
+			"items": {
+				"$ref": "#/definitions/Entry"
+			}
+		},
+		{
+			"type": "null"
+		}
+	],
+	"title": "Graft config file",
+	"description": "The entries that graft start loads. Each entry loads one plugin, or groups other entries.",
+	"definitions": {
+		"Intercept": {
+			"type": "object",
+			"properties": {
+				"effect/References/CurrentLogAnnotations": {
+					"type": "object",
+					"description": "Shallowly merges with outer annotations; configured keys win."
+				},
+				"effect/References/MinimumLogLevel": {
+					"type": "string",
+					"enum": [
+						"All",
+						"Fatal",
+						"Error",
+						"Warn",
+						"Info",
+						"Debug",
+						"Trace",
+						"None"
+					],
+					"description": "Replaces the outer minimum log level."
+				}
+			},
+			"additionalProperties": false,
+			"description": "Patches for references, applying to this entry and its descendants."
+		},
+		"Entry": {
+			"anyOf": [
+				{
+					"type": "object",
+					"properties": {
+						"id": {
+							"type": "string",
+							"description": "Identifies the entry. Graft adds one, and writes it to the file, if an entry has none."
+						},
+						"name": {
+							"type": "string",
+							"description": "The plugin's module: a relative path, a package name, or a short name. Ignored for groups."
+						},
+						"config": {
+							"type": "array",
+							"description": "The entries of this group.",
+							"items": {
+								"$ref": "#/definitions/Entry"
+							}
+						},
+						"disabled": {
+							"type": "boolean",
+							"description": "true unloads the entry but keeps it in the file."
+						},
+						"group": {
+							"type": "boolean",
+							"enum": [
+								true
+							],
+							"description": "true makes the entry a group of other entries."
+						},
+						"inject": {
+							"type": "array",
+							"description": "Service keys to wait for before loading the plugin, in addition to its own inject.",
+							"items": {
+								"type": "string"
+							}
+						},
+						"isolate": {
+							"type": "object",
+							"additionalProperties": {
+								"anyOf": [
+									{
+										"type": "boolean",
+										"enum": [
+											true
+										]
+									},
+									{
+										"type": "string"
+									}
+								]
+							},
+							"description": "Service or event keys to isolate: true for a private realm, or a label for a shared one."
+						},
+						"intercept": {
+							"$ref": "#/definitions/Intercept"
+						}
+					},
+					"required": [
+						"name",
+						"group"
+					],
+					"allOf": [
+						{
+							"type": "object",
+							"additionalProperties": {}
+						}
+					]
+				},
+				{
+					"type": "object",
+					"properties": {
+						"id": {
+							"type": "string",
+							"description": "Identifies the entry. Graft adds one, and writes it to the file, if an entry has none."
+						},
+						"name": {
+							"type": "string",
+							"description": "The plugin's module: a relative path, a package name, or a short name. Ignored for groups."
+						},
+						"config": {
+							"description": "The plugin's input. For a group, its list of entries."
+						},
+						"disabled": {
+							"type": "boolean",
+							"description": "true unloads the entry but keeps it in the file."
+						},
+						"group": {
+							"type": "boolean",
+							"enum": [
+								false
+							],
+							"description": "true makes the entry a group of other entries."
+						},
+						"inject": {
+							"type": "array",
+							"description": "Service keys to wait for before loading the plugin, in addition to its own inject.",
+							"items": {
+								"type": "string"
+							}
+						},
+						"isolate": {
+							"type": "object",
+							"additionalProperties": {
+								"anyOf": [
+									{
+										"type": "boolean",
+										"enum": [
+											true
+										]
+									},
+									{
+										"type": "string"
+									}
+								]
+							},
+							"description": "Service or event keys to isolate: true for a private realm, or a label for a shared one."
+						},
+						"intercept": {
+							"$ref": "#/definitions/Intercept"
+						}
+					},
+					"required": [
+						"name"
+					],
+					"allOf": [
+						{
+							"type": "object",
+							"additionalProperties": {}
+						}
+					]
+				}
+			]
+		}
+	}
+}

package/src/Manage.ts

@@ -0,0 +1,85 @@
+/**
+ * Creating projects and changing their dependencies.
+ */
+import * as Create from "@graftland/create"
+import * as PackageManager from "@graftland/package-manager"
+import {
+	Array,
+	Config,
+	Effect,
+	Option,
+	Predicate,
+	Record,
+	Schema,
+} from "effect"
+
+const report = (result: PackageManager.InstallResult) =>
+	Effect.logInfo(
+		`${result.agent}: ${result.added.length} added, ${result.updated.length} updated, ${result.removed.length} removed`,
+	)
+
+/**
+ * `name@range`, split at the last `@` so a scope's `@` stays in the name. A
+ * bare name means the latest version.
+ */
+const Spec = Schema.Union([
+	Schema.TemplateLiteralParser([
+		PackageManager.PackageName,
+		"@",
+		Schema.String,
+	]),
+	PackageManager.PackageName,
+])
+const decodeSpecs = Schema.decodeEffect(Schema.Array(Spec))
+
+const install = (
+	directory: string,
+	changes: Readonly<Record<string, string | null>>,
+) =>
+	Effect.gen(function* () {
+		const decoded = yield* Schema.decodeEffect(PackageManager.Changes)(changes)
+		// Set by npm, pnpm and Yarn when they run graft, such as through `pnpm dlx`.
+		const userAgent = yield* Config.String("npm_config_user_agent").pipe(
+			Config.withDefault(""),
+		)
+		const manager = yield* PackageManager.make({ directory, userAgent })
+		const result = yield* manager.install(decoded)
+		yield* report(result)
+	})
+
+export const create = (options: {
+	readonly directory: string
+	readonly name: Option.Option<string>
+	readonly install: boolean
+}) =>
+	Effect.gen(function* () {
+		const project = yield* Create.create({
+			directory: options.directory,
+			...Option.match(options.name, {
+				onNone: () => ({}),
+				onSome: (name) => ({ name }),
+			}),
+		})
+		yield* Effect.logInfo(`Created ${project.name} in ${project.directory}`)
+		if (options.install) yield* install(project.directory, {})
+	})
+
+export const add = (specs: ReadonlyArray<string>) =>
+	Effect.flatMap(decodeSpecs(specs), (specs) =>
+		install(
+			".",
+			Record.fromEntries(
+				Array.map(specs, (spec) =>
+					Predicate.isString(spec)
+						? ([spec, "latest"] as const)
+						: ([spec[0], spec[2]] as const),
+				),
+			),
+		),
+	)
+
+export const remove = (names: ReadonlyArray<string>) =>
+	install(
+		".",
+		Record.fromEntries(Array.map(names, (name) => [name, null] as const)),
+	)

package/src/Start.ts

@@ -0,0 +1,97 @@
+/**
+ * Runs a Graft application from its config file.
+ */
+import { NodeServices } from "@effect/platform-node"
+import { Graft, Plugin } from "@graftland/graft"
+import * as Hmr from "@graftland/hmr"
+import { Include, Loader, ModuleResolver, type Tree } from "@graftland/loader"
+import type { PlatformError, Schema } from "effect"
+import { Effect, FileSystem, Layer, Logger, Path } from "effect"
+import { EnvFile, layer as env, watchEnvFile } from "./internal/env"
+import { layer as intercepts } from "./internal/intercepts"
+import { watchModules } from "./internal/watch"
+
+export interface Options {
+	/** Path of the config file. */
+	readonly config: string
+	/** Reload plugin modules and the config file when they change. */
+	readonly watch: boolean
+	/**
+	 * A `.env` file that `!env` reads when the process environment does not set
+	 * a variable. With `watch`, changes to it are read again.
+	 */
+	readonly envFile?: string | undefined
+}
+
+/**
+ * Loads the entries of the config file and runs until interrupted. Plugin
+ * modules are imported through the hot reloader, so bare specifiers resolve
+ * from the application directory whether or not `watch` is on.
+ */
+export const run = (
+	options: Options,
+): Effect.Effect<
+	never,
+	| Graft.ServiceConflict
+	| PlatformError.BadArgument
+	| PlatformError.PlatformError
+	| Schema.SchemaError
+	| Loader.StoreError
+	| Tree.InvalidOperation
+> =>
+	Effect.gen(function* () {
+		const path = yield* Path.Path
+		const file = path.resolve(options.config)
+		const directory = path.dirname(file)
+		const base = yield* path.toFileUrl(file)
+		const hmr = yield* Hmr.make({ base: base.href })
+		const resolver = yield* ModuleResolver.make({
+			base: directory,
+			importer: hmr.importerScoped,
+		})
+		yield* Graft.provide(ModuleResolver.ModuleResolver, resolver)
+		const included = yield* Graft.plugin(Include.Include, {
+			path: file,
+			watch: options.watch,
+		})
+		yield* included.await
+		if (options.watch) {
+			const { reload } = yield* EnvFile
+			const envFile = options.envFile
+			const reloader = Plugin.make({
+				name: "reloader",
+				inject: [Loader.Loader, FileSystem.FileSystem, Path.Path],
+				apply: () =>
+					Effect.gen(function* () {
+						const loader = yield* Loader.Loader
+						yield* watchModules(hmr, directory, loader.retry).pipe(
+							Effect.forkScoped,
+						)
+						if (envFile !== undefined)
+							yield* watchEnvFile(envFile, reload, loader.retry).pipe(
+								Effect.forkScoped,
+							)
+					}),
+			})
+			yield* Graft.plugin(reloader)
+		}
+
+		yield* Effect.logInfo(
+			`Running ${path.relative(process.cwd(), file) || file}`,
+		)
+		return yield* Effect.never
+	}).pipe(
+		Effect.scoped,
+		// @effect-diagnostics-next-line strictEffectProvide:off -- this runs the whole application, so it is an entry point
+		Effect.provide(
+			Layer.provideMerge(
+				Graft.layer,
+				Layer.mergeAll(
+					NodeServices.layer,
+					intercepts,
+					env(options.envFile).pipe(Layer.provide(NodeServices.layer)),
+					Logger.layer([Logger.consolePretty()]),
+				),
+			),
+		),
+	)

package/src/bin.ts

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * The `graft` executable. Running this module starts the program.
+ */
+import { NodeRuntime, NodeServices } from "@effect/platform-node"
+import { Effect, Option } from "effect"
+import { Argument, Command, Flag } from "effect/cli"
+import { version } from "../package.json" with { type: "json" }
+import * as Manage from "./Manage"
+import * as Start from "./Start"
+
+const start = Command.make(
+	"start",
+	{
+		config: Argument.String("config").pipe(
+			Argument.withDescription("Path of the config file"),
+			Argument.withDefault("graft.yml"),
+		),
+		watch: Flag.Boolean("watch").pipe(
+			Flag.withAlias("w"),
+			Flag.withDescription("Reload plugins and config when files change"),
+			Flag.withDefault(false),
+		),
+		envFile: Flag.String("env-file").pipe(
+			Flag.withDescription(
+				"Read variables for !env from a .env file; the process environment takes precedence",
+			),
+			Flag.optional,
+		),
+	},
+	(options) =>
+		Start.run({ ...options, envFile: Option.getOrUndefined(options.envFile) }),
+).pipe(
+	Command.withDescription("Run the application described by a config file"),
+)
+
+const create = Command.make(
+	"create",
+	{
+		directory: Argument.String("directory").pipe(
+			Argument.withDescription("Where to create the project"),
+		),
+		name: Flag.String("name").pipe(
+			Flag.withDescription("Package name; defaults to the directory name"),
+			Flag.optional,
+		),
+		install: Flag.Boolean("install").pipe(
+			Flag.withDescription("Install dependencies afterwards"),
+			Flag.withDefault(false),
+		),
+	},
+	Manage.create,
+).pipe(Command.withDescription("Create a new Graft project"))
+
+const add = Command.make(
+	"add",
+	{ packages: Argument.variadic(Argument.String("package")) },
+	({ packages }) => Manage.add(packages),
+).pipe(
+	Command.withDescription(
+		"Add dependencies, restoring the project if installing fails",
+	),
+)
+
+const remove = Command.make(
+	"remove",
+	{ packages: Argument.variadic(Argument.String("package")) },
+	({ packages }) => Manage.remove(packages),
+).pipe(
+	Command.withDescription(
+		"Remove dependencies, restoring the project if installing fails",
+	),
+)
+
+const graft = Command.make("graft").pipe(
+	Command.withDescription("Run and manage Graft applications"),
+	Command.withSubcommands([start, create, add, remove]),
+)
+
+Command.run(graft, { version }).pipe(
+	Effect.provide(NodeServices.layer),
+	NodeRuntime.runMain,
+)

package/src/index.ts

@@ -0,0 +1,5 @@
+/**
+ * The graft command line.
+ */
+export * as Manage from "./Manage"
+export * as Start from "./Start"