@savvy-web/cli 0.1.0

package/bin/savvy.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { runCli } from "../841.js";
+runCli();

package/index.d.ts

@@ -0,0 +1,244 @@
+/**
+ * `@savvy-web/cli` — the `savvy` CLI for the Silk Suite.
+ *
+ * @remarks
+ * This entry point re-exports the `changeset`, `commit`, and `lint` command groups,
+ * their named handlers, and `runCli` — the assembled root `savvy` command with its
+ * merged runtime layer stack.
+ *
+ * @packageDocumentation
+ */
+
+import { BiomeSchemaSync } from '@savvy-web/silk-effects';
+import { Command } from '@effect/cli';
+import { ConfigDiscovery } from '@savvy-web/silk-effects';
+import { Effect } from 'effect';
+import { FileSystem } from '@effect/platform';
+import type { JsoncParseError } from 'jsonc-effect';
+import { ManagedSection } from '@savvy-web/silk-effects';
+import type { PlatformError } from '@effect/platform/Error';
+import type { SectionParseError } from '@savvy-web/silk-effects';
+import type { SectionWriteError } from '@savvy-web/silk-effects';
+import { ToolDiscovery } from '@savvy-web/silk-effects';
+import { VersioningStrategy } from '@savvy-web/silk-effects';
+import { WorkspaceDiscovery } from 'workspaces-effect';
+import { WorkspaceRoot } from 'workspaces-effect';
+
+/**
+ * The `savvy changeset` command group for use in Task B7 root assembly.
+ *
+ * @remarks
+ * Typed as `unknown` at the export boundary to avoid TypeScript declaration-emit
+ * errors from Effect's internal types. Task B7 should import and use this via
+ * `Command.withSubcommands([changesetCommand as never])` or re-infer the type.
+ */
+export declare const changesetCommand: Command.Command<"changeset", any, any, any>;
+
+/**
+ * The `savvy check` command for use in the Task B7 root assembly.
+ *
+ * @remarks
+ * Typed with `any` at the export boundary to avoid TypeScript declaration-emit
+ * errors from Effect's internal types. Task B7 should use this via
+ * `Command.withSubcommands([checkCommand as never])` or re-infer the type.
+ */
+export declare const checkCommand: Command.Command<"check", any, any, any>;
+
+/**
+ * The `savvy commit` command group for use in Task B7 root assembly.
+ *
+ * @remarks
+ * Typed as `unknown` at the export boundary to avoid TypeScript declaration-emit
+ * errors from Effect's internal types. Task B7 should import and use this directly
+ * as `Command.withSubcommands([commitCommand])` — the cast is for declaration emit only.
+ */
+export declare const commitCommand: Command.Command<"commit", any, any, any>;
+
+/**
+ * The `savvy init` command for use in the Task B7 root assembly.
+ *
+ * @remarks
+ * Typed with `any` at the export boundary to avoid TypeScript declaration-emit
+ * errors from Effect's internal types. Task B7 should use this via
+ * `Command.withSubcommands([initCommand as never])` or re-infer the type.
+ */
+export declare const initCommand: Command.Command<"init", any, any, any>;
+
+/**
+ * The `savvy lint` command group for use in Task B7 root assembly.
+ *
+ * @remarks
+ * Typed as `unknown` at the export boundary to avoid TypeScript declaration-emit
+ * errors from Effect's internal types. Task B7 should import and use this directly
+ * as `Command.withSubcommands([lintCommand])` — the cast is for declaration emit only.
+ */
+export declare const lintCommand: Command.Command<"lint", any, any, any>;
+
+/**
+ * Run the check validation pipeline on all changeset files in `dir`.
+ *
+ * Groups lint messages by file and logs a human-readable summary. Sets
+ * `process.exitCode = 1` when one or more errors are found.
+ *
+ * @param dir - Path to the changeset directory (resolved relative to cwd)
+ * @returns An Effect that performs validation and logs results
+ *
+ * @internal
+ */
+export declare function runChangesetCheck(dir: string): Effect.Effect<void, Error>;
+
+/**
+ * Run the full init pipeline.
+ *
+ * Exported so Task B5's unified `savvy init` orchestrator can invoke the
+ * changeset init step directly without going through the CLI command layer.
+ *
+ * @param opts - The same options the CLI command receives
+ * @returns An Effect that performs initialization
+ *
+ * @internal
+ */
+export declare function runChangesetInit(opts: {
+    force: boolean;
+    quiet: boolean;
+    skipMarkdownlint: boolean;
+    check: boolean;
+}): Effect.Effect<void, never, WorkspaceRoot>;
+
+/**
+ * Run all three check step Effects without short-circuiting.
+ *
+ * All three checks always run, sequentially (concurrency 1) so per-tool
+ * output stays grouped. If any fail, the combined Effect fails with all
+ * accumulated errors. Uses `Effect.all` with `{ concurrency: 1, mode: "validate" }`
+ * to collect every failure rather than stopping at the first.
+ *
+ * @param steps - The three step Effects to run. Injected for testability.
+ * @returns An Effect that resolves to `void` on success, or fails with the
+ *   union of all failing steps' errors.
+ */
+export declare function runCheck<EChangeset, RChangeset, ECommit, RCommit, ELint, RLint>(steps: {
+    changeset: Effect.Effect<unknown, EChangeset, RChangeset>;
+    commit: Effect.Effect<unknown, ECommit, RCommit>;
+    lint: Effect.Effect<unknown, ELint, RLint>;
+}): Effect.Effect<void, EChangeset | ECommit | ELint, RChangeset | RCommit | RLint>;
+
+/**
+ * Root `savvy` CLI entry point using `@effect/cli`.
+ *
+ * @remarks
+ * Assembles the five Phase-B command pieces — the `init` and `check` top-level
+ * orchestrators plus the `changeset`, `commit`, and `lint` groups — under a
+ * single `savvy` root command, then provides the merged runtime Layer stack
+ * that satisfies every command's service requirements.
+ *
+ * The layer stack is the union of the three standalone CLIs' stacks
+ * (`@savvy-web/changesets`, `@savvy-web/commitlint`, `@savvy-web/lint-staged`),
+ * with each service's transitive dependencies wired:
+ *
+ * - `NodeContext.layer` — `FileSystem`, `Path`, and `CommandExecutor`, consumed
+ *   by every config reader, workspace service, and tool-discovery layer.
+ * - Workspace services — `WorkspaceRootLive`, `PackageManagerDetectorLive`, and
+ *   `WorkspaceDiscoveryLive` (provided `WorkspaceRootLive`), the minimal hand-wired
+ *   trio shared by the three source CLIs.
+ * - Flat silk-effects services — `ChangesetConfigReaderLive`,
+ *   `SilkPublishabilityDetectorLive`, `ManagedSectionLive`, `BiomeSchemaSyncLive`,
+ *   `ConfigDiscoveryLive`, `ToolDiscoveryLive`, and `VersioningStrategyLive`
+ *   (provided `ChangesetConfigReaderLive`).
+ * - Changesets-namespace services — `Changesets.ConfigInspectorLive` (provided
+ *   `ChangesetConfigReaderLive`), `Changesets.WorkspaceSnapshotReaderLive`, and
+ *   `Changesets.BranchAnalyzerLive`, which shares the single `ConfigInspectorLive`
+ *   instance built once via `provideMerge`.
+ *
+ * The CLI version is injected at build time via `__PACKAGE_VERSION__`.
+ *
+ * @internal
+ */
+/**
+ * Bootstrap and run the `savvy` CLI application.
+ *
+ * @remarks
+ * Builds an Effect from the parsed `process.argv`, provides the merged layer
+ * stack, and hands execution to `NodeRuntime.runMain`.
+ *
+ * @internal
+ */
+export declare function runCli(): void;
+
+/**
+ * Run the check validation pipeline.
+ *
+ * Exported so Task B6's unified `savvy check` orchestrator can invoke the
+ * commitlint check step directly without going through the CLI command layer.
+ *
+ * @returns An Effect that performs validation and logs results
+ *
+ * @internal
+ */
+export declare function runCommitCheck(): Effect.Effect<void, SectionParseError | PlatformError, ManagedSection | FileSystem.FileSystem | VersioningStrategy | WorkspaceDiscovery>;
+
+/**
+ * Run the full init pipeline.
+ *
+ * Exported so Task B5's unified `savvy init` orchestrator can invoke the
+ * commitlint init step directly without going through the CLI command layer.
+ *
+ * @param opts - The same options the CLI command receives
+ * @returns An Effect that performs initialization
+ *
+ * @internal
+ */
+export declare function runCommitInit(opts: {
+    force: boolean;
+    config: string;
+}): Effect.Effect<void, Error | SectionWriteError | PlatformError, ManagedSection | FileSystem.FileSystem>;
+
+/**
+ * Run the three init step Effects in order: changeset → commit → lint.
+ *
+ * Monadic sequencing via `Effect.gen` short-circuits on the first failure —
+ * if changeset fails, neither commit nor lint will run.
+ *
+ * @param steps - The three step Effects to sequence. Injected for testability.
+ * @returns An Effect that resolves to `void` on success, or fails with the
+ *   error of the first failing step.
+ */
+export declare function runInit<EChangeset, RChangeset, ECommit, RCommit, ELint, RLint>(steps: {
+    changeset: Effect.Effect<unknown, EChangeset, RChangeset>;
+    commit: Effect.Effect<unknown, ECommit, RCommit>;
+    lint: Effect.Effect<unknown, ELint, RLint>;
+}): Effect.Effect<void, EChangeset | ECommit | ELint, RChangeset | RCommit | RLint>;
+
+/**
+ * Run the lint check validation pipeline.
+ *
+ * Exported so Task B6's unified `savvy check` orchestrator can invoke the
+ * lint check step directly without going through the CLI command layer.
+ *
+ * @param opts - Options for the check command
+ * @returns An Effect that performs validation and logs results
+ *
+ * @internal
+ */
+export declare function runLintCheck(opts: {
+    quiet: boolean;
+}): Effect.Effect<void, JsoncParseError | SectionParseError | PlatformError, ManagedSection | FileSystem.FileSystem | ToolDiscovery | ConfigDiscovery>;
+
+/**
+ * Run the full lint init pipeline.
+ *
+ * Exported so Task B5's unified `savvy init` orchestrator can invoke the
+ * lint-staged init step directly without going through the CLI command layer.
+ *
+ * @param opts - The same options the CLI command receives
+ * @returns An Effect that performs initialization
+ *
+ * @internal
+ */
+export declare function runLintInit(opts: {
+    force: boolean;
+    config: string;
+    preset: "minimal" | "standard" | "silk";
+}): Effect.Effect<void, Error | SectionWriteError | PlatformError, ManagedSection | FileSystem.FileSystem | BiomeSchemaSync>;
+
+export { }

package/index.js

@@ -0,0 +1 @@
+export { changesetCommand, checkCommand, commitCommand, initCommand, lintCommand, runChangesetCheck, runChangesetInit, runCheck, runCli, runCommitCheck, runCommitInit, runInit, runLintCheck, runLintInit } from "./841.js";

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@savvy-web/cli",
+  "version": "0.1.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",
+  "bugs": {
+    "url": "https://github.com/savvy-web/systems/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/savvy-web/systems.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "C. Spencer Beggs",
+    "email": "spencer@savvyweb.systems",
+    "url": "https://savvyweb.systems"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "bin": {
+    "savvy": "bin/savvy.js"
+  },
+  "dependencies": {
+    "@effect/cli": "^0.75.1",
+    "@effect/platform": "^0.96.1",
+    "@effect/platform-node": "^0.106.0",
+    "@savvy-web/silk-effects": "0.6.0",
+    "effect": "^3.21.2",
+    "jsonc-effect": "^0.2.1",
+    "workspaces-effect": "^1.1.0",
+    "yaml": "^2.9.0"
+  },
+  "files": [
+    "!cli.api.json",
+    "!tsconfig.json",
+    "!tsdoc.json",
+    "841.js",
+    "bin/savvy.js",
+    "index.d.ts",
+    "index.js",
+    "package.json",
+    "tsdoc-metadata.json"
+  ]
+}

package/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.58.7"
+    }
+  ]
+}