@savvy-web/cli 2.5.4 → 2.6.0

package/cli/index.js

@@ -76,7 +76,7 @@ const rootCommand = Command.make("savvy").pipe(Command.withSubcommands([
 * CLI application: reads argv from the Stdio service provided by NodeServices.
 * (v4's `Command.run` takes only `version` — the name comes from the root command.)
 */
-const cli = Command.run(rootCommand, { version: "2.5.4" });
+const cli = Command.run(rootCommand, { version: "2.6.0" });
 /**
 * Shared workspace services from `@effected/workspaces`, wired as a
 * self-contained unit and built ONCE (layers memoize by reference).

package/commands/repos/commands/deregister.js

@@ -0,0 +1,67 @@
+import { Repos } from "@savvy-web/silk-effects";
+import { Effect } from "effect";
+import { Argument, Command, Flag } from "effect/unstable/cli";
+
+//#region src/commands/repos/commands/deregister.ts
+/**
+* `repos deregister` command -- clear a stale submodule registration from the
+* superproject's LOCAL git config.
+*
+* @remarks
+* A thin adapter over {@link Repos.ReposManager.deregister}: removes the
+* `submodule.<section>` section a rename or an unvendoring left behind — the
+* phantom entry `savvy repos status --drift` reports as
+* `localRegistrationDivergence` with no matching manifest entry. The section
+* argument is the registration name exactly as the drift report states it
+* (e.g. `.repos/old-name`); the `submodule.` prefix is implied.
+*
+* Unlike the other mutating repos commands, nothing is staged afterwards:
+* the local git config is unversioned, so there is nothing to commit. It also
+* never touches a vendored worktree, so no lockdown bracket is involved and
+* `ReposLockdownError` is not in its error union.
+*
+* Every failure here is a REAL failure (exit 1): a `ReposConfigError` means
+* the section still backs a live manifest entry (use `remove` to unvendor, or
+* `sync` to reconcile), the section is not registered at all (usually a
+* typo), or the manifest itself is unreadable; a `GitSubmoduleError` means
+* the underlying git command failed. There is no friendly missing-manifest
+* exit-0 case: the manager folds a missing manifest to "no live entries" and
+* proceeds, since a stale registration can outlive the manifest itself.
+*
+* @example
+* ```bash
+* savvy repos deregister .repos/old-name
+* ```
+*
+* @internal
+*/
+/* v8 ignore start -- CLI option/arg definitions */
+const sectionArg = Argument.string("section");
+const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root to deregister within"), Flag.withDefault("."));
+/* v8 ignore stop */
+/**
+* Deregister handler; exported for tests.
+*
+* @internal
+*/
+const runReposDeregister = (cwd, section) => Effect.gen(function* () {
+	const result = yield* (yield* Repos.ReposManager).deregister(cwd, section);
+	yield* Effect.log(`${result.section}: deregistered (${result.removedKeys.length} config keys removed)`);
+	for (const key of result.removedKeys) yield* Effect.log(`  removed ${key}`);
+	yield* Effect.log("local git config only — nothing to commit");
+}).pipe(Effect.catchTag("ReposConfigError", (error) => {
+	process.exitCode = 1;
+	return Effect.log(error.message);
+}), Effect.catchTag("GitSubmoduleError", (error) => {
+	process.exitCode = 1;
+	return Effect.log(error.message);
+}));
+/* v8 ignore start -- CLI registration; handler tested via runReposDeregister */
+const deregisterCommand = Command.make("deregister", {
+	section: sectionArg,
+	cwd: cwdOption
+}, ({ section, cwd }) => runReposDeregister(cwd, section)).pipe(Command.withDescription("Clear a stale submodule registration (a submodule.<section> section matching no manifest entry) from the local git config"));
+/* v8 ignore stop */
+
+//#endregion
+export { deregisterCommand, runReposDeregister };

package/commands/repos/index.js

@@ -1,4 +1,5 @@
 import { addCommand, runReposAdd } from "./commands/add.js";
+import { deregisterCommand, runReposDeregister } from "./commands/deregister.js";
 import { noteCommand, runReposNote } from "./commands/note.js";
 import { pinCommand, runReposPin } from "./commands/pin.js";
 import { removeCommand, runReposRemove } from "./commands/remove.js";
@@ -18,7 +19,8 @@ const _reposCommand = Command.make("repos").pipe(Command.withSubcommands([
 	noteCommand,
 	removeCommand,
 	renameCommand,
-	restoreCommand
+	restoreCommand,
+	deregisterCommand
 ]), Command.withDescription("Vendored reference repos under .repos/"));
 /**
 * The `savvy repos` command group.
@@ -38,8 +40,8 @@ const _reposCommand = Command.make("repos").pipe(Command.withSubcommands([
 * `status --drift` runs `Repos.ReposDrift.check` after the status check.
 *
 * The error channel is `Repos.GitSubmoduleError` alone: `add`/`pin`/`note`/
-* `remove`/`rename`/`restore`/`sync` each `catchTag` every error their
-* underlying `ReposManager` method can produce — `ReposConfigError`,
+* `remove`/`rename`/`restore`/`sync`/`deregister` each `catchTag` every error
+* their underlying `ReposManager` method can produce — `ReposConfigError`,
 * `GitSubmoduleError`, `RepoNotFoundError`, `NoteNotFoundError`, and (for the
 * six ops that unlock/re-lock the vendored tree around a git mutation)
 * `ReposLockdownError` — down to a logged message and a non-zero exit code,

package/index.d.ts

@@ -301,8 +301,8 @@ declare const runReposSync: (cwd: string) => Effect.Effect<void, never, Repos.Re
  * `status --drift` runs `Repos.ReposDrift.check` after the status check.
  *
  * The error channel is `Repos.GitSubmoduleError` alone: `add`/`pin`/`note`/
- * `remove`/`rename`/`restore`/`sync` each `catchTag` every error their
- * underlying `ReposManager` method can produce — `ReposConfigError`,
+ * `remove`/`rename`/`restore`/`sync`/`deregister` each `catchTag` every error
+ * their underlying `ReposManager` method can produce — `ReposConfigError`,
  * `GitSubmoduleError`, `RepoNotFoundError`, `NoteNotFoundError`, and (for the
  * six ops that unlock/re-lock the vendored tree around a git mutation)
  * `ReposLockdownError` — down to a logged message and a non-zero exit code,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/cli",
-	"version": "2.5.4",
+	"version": "2.6.0",
 	"private": false,
 	"description": "The savvy CLI — unified commit, changeset, and lint commands for the Silk Suite",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/cli",
@@ -33,12 +33,12 @@
 	"dependencies": {
 		"@effect/platform-node": "4.0.0-beta.107",
 		"@effected/commands": "^0.4.0",
-		"@effected/git": "^0.7.0",
+		"@effected/git": "^0.8.0",
 		"@effected/jsonc": "^0.6.0",
 		"@effected/templates": "^0.2.0",
-		"@effected/workspaces": "^0.12.0",
+		"@effected/workspaces": "^0.13.0",
 		"@effected/yaml": "^0.8.0",
-		"@savvy-web/silk-effects": "5.8.0",
+		"@savvy-web/silk-effects": "5.9.0",
 		"effect": "4.0.0-beta.107"
 	}
 }