@evcraddock/slug-cli 0.2.0

package/README.md

@@ -0,0 +1,46 @@
+# slug CLI
+
+Foundation package for the `slug` command-line tool. Release instructions are documented in [../docs/cli-release.md](../docs/cli-release.md).
+
+## Development
+
+From the repository root:
+
+```bash
+npm run test --workspace @evcraddock/slug-cli
+npm run typecheck --workspace @evcraddock/slug-cli
+```
+
+Run locally with Node's TypeScript loader:
+
+```bash
+node --import tsx cli/src/index.ts --help
+```
+
+## Site initialization
+
+Create a standalone site with:
+
+```bash
+slug init ./my-site --name my-site --site-title "My Site"
+```
+
+Run `slug init --help` for template options. In repository-local development, `slug init` copies `template/site` directly. Installed CLI releases download the matching versioned template asset from the Forgejo release unless `--template-url` or `--template-dir` is provided.
+
+## Login and configuration
+
+Run `slug login` to open the site's browser auth flow, paste the generated API key, verify it, and save the config. Use `slug doctor` to check configured site reachability and compatibility. Use `slug --config ./dev.slug.yaml login` to run with a specific config file.
+
+The CLI stores YAML config at `${XDG_CONFIG_HOME:-~/.config}/slug/config.yaml` by default. Tests and isolated runs can set `SLUG_CONFIG_HOME` to override the config directory. `slug config show` reports whether an API key is configured without printing the key.
+
+Use `slug site config show` to read supported runtime site configuration through the Slugkit API. Use `slug site config set <field> <value>` to update supported fields such as `name`, `url`, `tagline`, `description`, `homepage.intro`, and `homepage.body`.
+
+Use `slug post list`, `slug post show <slug>`, `slug post create`, `slug post edit <slug>`, `slug post publish <slug>`, `slug post unpublish <slug>`, and `slug post delete <slug>` to manage posts through the Slugkit posts API.
+
+Use `slug tag list` to list tags and post usage counts through the Slugkit tags API.
+
+Example config:
+
+```yaml
+apiBaseUrl: https://example.com/api/v1
+```

package/dist/commands.d.ts

@@ -0,0 +1,18 @@
+import { ExitCode } from "./errors.js";
+import { type OutputWriter } from "./output.js";
+export interface CommandContext {
+    args: string[];
+    configPath: string;
+    packageVersion: string;
+    writer: OutputWriter;
+    fetchImpl?: typeof fetch;
+    openUrl?: (url: string) => Promise<void> | void;
+    prompt?: (message: string) => Promise<string> | string;
+    templateSiteDirectory?: string | null;
+    templateAssetBaseUrl?: string;
+}
+export interface CommandResult {
+    exitCode: ExitCode;
+}
+export declare function runCommand(context: CommandContext): Promise<CommandResult>;
+export declare function createBrowserAuthUrl(apiBaseUrl: string): string;