@wootsup/yt-builder-mcp 1.1.6 → 1.2.0

package/dist/setup-cli.d.ts

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+/**
+ * Top-level CLI dispatcher for `@wootsup/yt-builder-mcp`.
+ *
+ * Round-1 audit I5 fix (2026-05-22): the wizard implementation lives in
+ * `setup-wizard.ts`; this file is the thin dispatcher (`runCli`) plus
+ * the ESM main-guard. Both have their own deps-bag (`WizardDeps` /
+ * `RunCliDeps`) so unit tests can drive them independently.
+ *
+ * Subcommands:
+ *
+ *   setup (default)   — runWizard (see `setup-wizard.ts`)
+ *   install-skill     — copy the bundled skill into ~/.claude/skills/
+ *                       and append a marker block to ~/AGENTS.md.
+ *   --help / help     — print usage.
+ *   --version / -v    — print the package version.
+ *
+ * Re-exports `runWizard`, `majorMinor` and the wizard public types so
+ * existing callers (and tests that already import from `./setup-cli`)
+ * keep working with a one-line import.
+ *
+ * @license MIT
+ */
+import { installSkill as defaultInstallSkill } from './install-skill.js';
+import type { WizardDeps } from './setup-wizard-types.js';
+import { type InstalledClient, type UninstallDeps, type UninstallSelection } from './uninstall.js';
+import { type AddSiteArgs, type AddSiteDeps, type AddSiteResult } from './sites/cli/add-site.js';
+import { type ListSitesDeps } from './sites/cli/list-sites.js';
+import { type RemoveSiteDeps } from './sites/cli/remove-site.js';
+import { type SetDefaultDeps } from './sites/cli/set-default.js';
+import { type TestSiteDeps } from './sites/cli/test-site.js';
+export { DEFAULT_WIZARD_DEPS, majorMinor, runWizard, type AuthProbeResult, type HandshakeResult, type HealthProbeResult, type WizardAnswers, type WizardDeps, type WriteResult, } from './setup-wizard.js';
+export interface ParsedSetupArgs {
+    /** True when `--non-interactive` was passed. Always boolean. */
+    readonly nonInteractive: boolean;
+    /** Site base URL from `--url` (WordPress or Joomla), trailing slash stripped, trimmed. */
+    readonly url: string;
+    /** Bearer token from `--token`, trimmed. */
+    readonly token: string;
+    /** Client ids from repeated `--client`. */
+    readonly clients: readonly string[];
+    /**
+     * Pickup URL from `--pickup`, trimmed. When set together with
+     * `nonce`, the wizard fetches the Bearer + canonical URL from the
+     * plugin in a single POST instead of prompting.
+     */
+    readonly pickup?: string;
+    /** One-shot nonce from `--nonce`, trimmed. Pairs 1:1 with `pickup`. */
+    readonly nonce?: string;
+    /**
+     * Human-readable validation errors. Empty array means the parsed
+     * args are usable. The dispatcher prints these to stderr and exits
+     * non-zero when non-empty AND `--non-interactive` was requested.
+     */
+    readonly errors: readonly string[];
+    /**
+     * Non-fatal warnings to surface on stderr (e.g. "--url ignored in
+     * pickup mode"). These do NOT block the wizard from running.
+     */
+    readonly warnings: readonly string[];
+}
+/**
+ * Parse the `setup` subcommand argv tail. Pure function; does no I/O.
+ *
+ * Accepts both `--key value` and `--key=value` styles. Unknown flags
+ * are reported as errors so typos don't silently disable validation.
+ */
+export declare function parseSetupArgs(argv: readonly string[]): ParsedSetupArgs;
+/**
+ * Build a `WizardDeps` bag that answers prompts from CLI flags instead
+ * of asking a human. Reuses every other dependency (probes, writes,
+ * handshake) from `DEFAULT_WIZARD_DEPS` so the wizard's exit-code
+ * contract (0/2/3/4/5) stays identical.
+ *
+ * `confirmContinue` always returns `false` — there is no human to ask,
+ * so a probe failure cleanly aborts with the documented exit code.
+ */
+export declare function buildNonInteractiveDeps(parsed: ParsedSetupArgs, base?: WizardDeps): WizardDeps;
+/**
+ * Build a `WizardDeps` bag for the Wave-C pickup flow. The wizard's
+ * `prompt` step calls `base.fetchPickup(url, nonce)` once, then
+ * synthesises the `WizardAnswers` from the response — the actual answers
+ * (token + canonical WordPress URL) come straight from the plugin via
+ * a 256-bit one-shot nonce, never through chat history / provider logs.
+ *
+ * On `fetchPickup` failure the prompt resolves to `null` so the wizard
+ * exits cleanly with code 130 (user-cancel equivalent — we treat
+ * an unrecoverable pickup as "the conversation ends here"). The
+ * thrown error is logged via the `log` dep so the operator sees why.
+ *
+ * `confirmContinue` returns `false` (same rationale as non-interactive).
+ */
+export declare function buildPickupDeps(parsed: ParsedSetupArgs, base?: WizardDeps): WizardDeps;
+/**
+ * Parsed shape for the `add-site` subcommand. Pure-data; tests
+ * exercise this without filesystem deps.
+ */
+export interface ParsedAddSiteArgs {
+    readonly url: string;
+    readonly token: string;
+    readonly tokenRef: string;
+    readonly platform?: 'auto' | 'wordpress' | 'joomla';
+    readonly label: string;
+    readonly siteId: string;
+    readonly default: boolean;
+    readonly yes: boolean;
+    readonly sitesFile?: string;
+    readonly errors: readonly string[];
+}
+/**
+ * Parse `add-site` flags from the tail of argv. Accepts both
+ * `--key value` and `--key=value` styles. Unknown flags are reported
+ * as errors so typos never silently disable validation.
+ */
+export declare function parseAddSiteArgs(argv: readonly string[]): ParsedAddSiteArgs;
+/** Parsed shape for the `uninstall` / `remove` subcommands. Pure-data. */
+export interface ParsedUninstallArgs {
+    /** `--all`: non-interactive complete uninstall. */
+    readonly all: boolean;
+    /** `--yes` / `-y`: skip the final confirmation. */
+    readonly yes: boolean;
+    /** `--help` / `-h` requested. */
+    readonly helpRequested: boolean;
+    /** Validation errors (unknown flags, stray values). Empty when usable. */
+    readonly errors: readonly string[];
+}
+/**
+ * Parse the `uninstall` / `remove` argv tail. Pure; does no I/O. Accepts
+ * only boolean flags — `--all`, `--yes`/`-y`, `--help`/`-h`. Any value
+ * (`--all=x`) or unknown flag is an error so typos don't silently change
+ * the destructive behaviour.
+ */
+export declare function parseUninstallArgs(argv: readonly string[]): ParsedUninstallArgs;
+export interface RunCliDeps {
+    /**
+     * Wizard runner. The optional deps bag lets the non-interactive
+     * dispatcher inject prebuilt answers; interactive callers pass
+     * nothing and the wizard uses `DEFAULT_WIZARD_DEPS`.
+     */
+    runWizard: (deps?: WizardDeps) => Promise<number>;
+    installSkill: typeof defaultInstallSkill;
+    log?: (line: string) => void;
+    error?: (line: string) => void;
+    /** Test injection — override the resolved sites.json path. */
+    resolveSitesPath?: () => string;
+    addSiteDeps?: AddSiteDeps;
+    listSitesDeps?: ListSitesDeps;
+    removeSiteDeps?: RemoveSiteDeps;
+    setDefaultDeps?: SetDefaultDeps;
+    testSiteDeps?: TestSiteDeps;
+    /**
+     * W12-R2A — y/N prompt for destructive subcommands (remove-site,
+     * set-default). Defaults to {@link defaultConfirmTTY} which reads
+     * from process.stdin via readline. Tests inject a stub.
+     *
+     * Note: when the operator passes `--yes`, this hook is NEVER
+     * invoked — the subcommand factory short-circuits before reaching
+     * the confirm step. When `--yes` is absent AND no confirm hook is
+     * injectable (CI / piped stdin), the factory throws a typed
+     * CONFIRM_REQUIRED / SET_DEFAULT_CONFIRM_REQUIRED error.
+     */
+    confirm?: (message: string) => Promise<boolean>;
+    /**
+     * Optional override for the post-wizard `addSiteCommand` call.
+     * Tests stub this to assert the wizard wires through addSiteCommand
+     * without writing to disk.
+     */
+    addSiteFromWizard?: (args: AddSiteArgs, path: string) => Promise<AddSiteResult>;
+    /**
+     * Uninstall orchestration deps (client registry + skill remover).
+     * Defaults to {@link DEFAULT_UNINSTALL_DEPS}; tests inject fakes so no
+     * real config files are touched.
+     */
+    uninstallDeps?: UninstallDeps;
+    /**
+     * Detection probe for the uninstall flow. Defaults to
+     * {@link defaultDetectInstalled} run against the uninstall deps'
+     * client registry. Tests stub this to control which clients appear.
+     */
+    detectInstalled?: (clients: UninstallDeps['clients']) => Promise<InstalledClient[]>;
+    /**
+     * Interactive uninstall checklist. Defaults to
+     * {@link defaultUninstallPrompt} (clack). Returns the selection or
+     * `null` on cancel. Tests inject a stub to avoid driving clack.
+     */
+    promptUninstall?: (input: {
+        readonly detected: readonly InstalledClient[];
+        readonly skillInstalled: boolean;
+        readonly skipFinalConfirm?: boolean;
+    }) => Promise<UninstallSelection | null>;
+}
+export declare function runCli(argv: readonly string[], deps?: Partial<RunCliDeps>): Promise<number>;
+//# sourceMappingURL=setup-cli.d.ts.map

package/dist/setup-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-cli.d.ts","sourceRoot":"","sources":["../src/setup-cli.ts"],"names":[],"mappings":"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"}