@ttctl/cli 0.0.0 → 0.1.0-rc.1

package/dist/program.js

@@ -0,0 +1,273 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { existsSync } from "node:fs";
+import { Command, Option } from "commander";
+import { ConfigError, setDiagnosticLogger } from "@ttctl/core";
+import { buildApplicationsCommand } from "./commands/applications/index.js";
+import { registerAuthCommand } from "./commands/auth/index.js";
+import { buildAvailabilityCommand } from "./commands/availability/index.js";
+import { buildContractsCommand } from "./commands/contracts/index.js";
+import { buildEngagementsCommand } from "./commands/engagements/index.js";
+import { buildJobsCommand } from "./commands/jobs/index.js";
+import { buildPaymentsCommand } from "./commands/payments/index.js";
+import { buildTimesheetCommand } from "./commands/timesheet/index.js";
+import { buildProfileCommand } from "./commands/profile/index.js";
+import { setCliConfigPath } from "./lib/config-context.js";
+import { DRY_RUN_NO_OP_STDERR_NOTE, isMutationCommand, setCliDryRun } from "./lib/dry-run.js";
+import { runKillSwitchAtStartup } from "./lib/kill-switch-hook.js";
+/**
+ * Build the root TTCtl Commander program. Sub-commands are registered as they
+ * land in milestones; the program is shaped as a noun-verb tree (e.g.,
+ * `ttctl profile show`, `ttctl timesheet list`).
+ *
+ * Global options:
+ *
+ *   `--config <path>` — explicit path to the YAML config, takes precedence
+ *   over `TTCTL_CONFIG_FILE` and the home dotfile. Validated at invocation
+ *   time (before any sub-command's action runs) — a missing file surfaces
+ *   as `ConfigError(code: NO_CREDS)` rather than failing later inside
+ *   `loadConfigFile`. Honors `aws --profile` / `kubectl --kubeconfig` UX
+ *   expectations.
+ *
+ *   Resolution precedence (highest → lowest, post-#107):
+ *
+ *     1. `--config <path>`         — this flag (per-invocation)
+ *     2. `TTCTL_CONFIG_FILE` env   — process-scoped (CI, direnv)
+ *     3. `~/.ttctl.yaml`           — POSIX home dotfile (only fallback)
+ *
+ *   The CWD `./.ttctl.yaml` is NOT auto-discovered (closed in #92).
+ *   XDG paths (`$XDG_CONFIG_HOME/ttctl/config.yaml`,
+ *   `~/.config/ttctl/config.yaml`) are NOT consulted (closed in #107 — the
+ *   single-file model places the captured bearer in the same YAML, so
+ *   `~/.ttctl.yaml` is the canonical home location).
+ *
+ *   `--json` / `--yaml` — boolean shortcuts for `--output=json` /
+ *   `--output=yaml` (post-#126). Mutual exclusion with `--output`/`-o` is
+ *   enforced in the preAction hook: any two of `{--output, -o, --json,
+ *   --yaml}` present together raise a parse-time error before the
+ *   sub-command's action runs.
+ *
+ *   `--dry-run` (issue #52) — preview a mutation without sending it.
+ *   Captured into the module-scoped `cliDryRun` holder via
+ *   `setCliDryRun` in the preAction hook so mutation handlers can read
+ *   it through `getCliDryRun()`. Leaf commands tagged via
+ *   `markMutation()` (in their `build*Command` factories) route the
+ *   value through to the core layer's `dryRun` option; non-mutation
+ *   leaves get a one-line stderr no-op note from the preAction hook
+ *   (`DRY_RUN_NO_OP_STDERR_NOTE`) and proceed normally.
+ *
+ *   MCP tool integration is conditional on issue #10 having landed —
+ *   when MCP tools that wrap mutations ship, they accept the same
+ *   `dryRun?: boolean` input parameter and route through the same core
+ *   `dryRun` option. Until then, no MCP-side wiring is required.
+ *
+ *   `--verbose` / `--debug` (issue #139) — diagnostic observability for
+ *   transport-level request/response activity. `--verbose` emits a
+ *   one-line request descriptor + one-line response status per
+ *   transport call to STDERR; `--debug` emits full JSON-encoded
+ *   request/response envelopes (including redacted headers and body)
+ *   to STDERR. Both write EXCLUSIVELY to stderr — the stdout data
+ *   channel (json/yaml/pretty envelopes per #126/#128) is never
+ *   touched, so `--debug --output=json` works as one would expect:
+ *   structured data on stdout, redacted debug trace on stderr.
+ *
+ *   Mutual relationship: `--debug` is a strict superset of
+ *   `--verbose`; if both are passed, `--debug` wins (no warning —
+ *   the user got what they implicitly asked for, the verbose-tier
+ *   data is a subset of the debug-tier data). The preAction hook
+ *   computes the effective level and routes it through
+ *   `setDiagnosticLogger` so every transport (stockTransport,
+ *   impersonatedTransport, impersonatedMultipartTransport, and the
+ *   hand-rolled photo-upload path in profile/basic) emits the same
+ *   shape. Secret redaction (cookies, authorization headers,
+ *   password / token / secret body fields, the
+ *   `user_<24hex>_<20alnum>` bearer pattern) is applied by the
+ *   `redact` module BEFORE serialization, so verbatim bearers /
+ *   cookies cannot appear in either log tier.
+ *
+ * Pagination flags are declared PER paginating leaf (`jobs list`,
+ * `jobs saved`, `jobs viewed`, `jobs not-interested-list`) rather
+ * than globally — see #183 (follow-up to #138). The leaf's `--help`
+ * is the source of truth for "does this command paginate?"; Commander
+ * emits its standard `error: unknown option '--page'` (exit 1) when
+ * the flag is passed to a non-paginating leaf.
+ */
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name("ttctl")
+        .description("Unofficial CLI for the Toptal Talent platform — personal-productivity tool")
+        .version("0.0.0")
+        .addOption(new Option("--config <path>", "path to YAML config (overrides TTCTL_CONFIG_FILE and ~/.ttctl.yaml)"))
+        .addOption(new Option("--json", "shortcut for --output=json (mutually exclusive with --output, -o, --yaml)"))
+        .addOption(new Option("--yaml", "shortcut for --output=yaml (mutually exclusive with --output, -o, --json)"))
+        .addOption(new Option("--dry-run", "preview a mutation request without sending it (no-op for read commands)").default(false))
+        .addOption(new Option("--verbose", "log request/response summary to stderr (issue #139)").default(false))
+        .addOption(new Option("--debug", "log full request/response (headers + body, redacted) to stderr (issue #139)").default(false))
+        .hook("preAction", (thisCommand, actionCommand) => {
+        // `thisCommand` is the root program where the hook is registered;
+        // global options are read off it directly. The hook fires before
+        // every sub-command's action, so the path is captured exactly once
+        // per invocation. `actionCommand` is the deepest command being
+        // executed (e.g., the `init` leaf under `auth init`).
+        const opts = thisCommand.opts();
+        const configPath = opts.config;
+        // Mutual exclusion across format flags (post-#126). The user-visible
+        // surface is `--output={pretty,yaml,json}` plus boolean shortcuts
+        // `--json` / `--yaml`. Any two flags from the set
+        // `{--output, -o, --json, --yaml}` present together is a parse-time
+        // error — fired BEFORE the sub-command's action runs so the error
+        // message is uniform regardless of which leaf the user invoked.
+        //
+        // `getOptionValueSource("output")` distinguishes "user passed it"
+        // (source === `"cli"`) from "Commander filled the default"
+        // (source === `"default"`). Without this check the default value
+        // would always fire and every `--json` / `--yaml` use would be
+        // (incorrectly) flagged as a conflict.
+        const outputExplicit = actionCommand.getOptionValueSource("output") === "cli";
+        const explicitFlags = [];
+        if (outputExplicit) {
+            const out = actionCommand.opts().output;
+            explicitFlags.push(`--output=${out ?? ""}`);
+        }
+        if (opts.json === true)
+            explicitFlags.push("--json");
+        if (opts.yaml === true)
+            explicitFlags.push("--yaml");
+        if (explicitFlags.length > 1) {
+            const head = explicitFlags.slice(0, -1).join(", ");
+            const tail = explicitFlags[explicitFlags.length - 1] ?? "";
+            process.stderr.write(`Error: Conflicting output flags: ${head} and ${tail}\n`);
+            process.exit(1);
+        }
+        // Propagate `--json` / `--yaml` to the action command's `output`
+        // option. Sub-commands that don't carry an `--output` option simply
+        // ignore the propagation (Commander tolerates `setOptionValue` on
+        // an unknown key — the action handler never reads it).
+        const hasOutputOption = actionCommand.options.some((o) => o.long === "--output");
+        if (hasOutputOption) {
+            if (opts.json === true) {
+                actionCommand.setOptionValue("output", "json");
+            }
+            else if (opts.yaml === true) {
+                actionCommand.setOptionValue("output", "yaml");
+            }
+        }
+        // `auth init` is a BOOTSTRAP command — its own `--config <path>`
+        // flag is the OUTPUT destination, which by definition must not
+        // exist (or `--force` is required). Both Commander's parser AND
+        // the user's `program.opts()` see the same flag value, so the
+        // global existence check would fire incorrectly here. Skip the
+        // gate for `auth init` and let its own action handler govern the
+        // path semantics. Other sub-commands (status / signin / signout /
+        // profile / …) all read existing configs and benefit from the
+        // gate.
+        const isAuthInit = isAuthInitCommand(actionCommand);
+        if (configPath !== undefined && !isAuthInit) {
+            if (!existsSync(configPath)) {
+                // AC: validate at invocation time, don't wait for the first
+                // command that loads it. Surface as `ConfigError(NO_CREDS)`
+                // with the same uniform shape `loadConfigFile` produces, so
+                // script consumers see one code regardless of where the
+                // missing-file check fired.
+                const err = new ConfigError(`Config file not found: ${configPath}`, "NO_CREDS", configPath);
+                process.stderr.write(`Error (${err.code}): ${err.message}\n`);
+                process.exit(1);
+            }
+        }
+        // For `auth init`: do NOT propagate the global `--config` value as
+        // the CLI-context's "input config path" — the init handler's own
+        // `options.config` carries the OUTPUT destination, semantically
+        // different from a file-must-exist input config. Setting the
+        // context to undefined keeps the read-side resolver unaware that
+        // the output path was supplied (it would be the wrong target
+        // anyway: init is creating, not reading).
+        setCliConfigPath(isAuthInit ? undefined : configPath);
+        // Capture the global `--dry-run` flag (issue #52). Commander's
+        // `Option.default(false)` means `opts.dryRun` is `false` when the
+        // flag is omitted, `true` when present — no need to coerce
+        // `undefined`. Mutation handlers read the captured value through
+        // `getCliDryRun()` and route through the core's `dryRun` option.
+        const dryRun = opts.dryRun === true;
+        setCliDryRun(dryRun);
+        // Capture the global `--verbose` / `--debug` flags (issue #139).
+        // `--debug` is a strict superset of `--verbose`; if both are
+        // passed, `--debug` wins silently (verbose's lines are a subset
+        // of debug's content). The level routes through `setDiagnosticLogger`
+        // to the core's transport layer, where every request/response is
+        // logged with secret redaction applied by the `redact` module
+        // BEFORE serialization. Output goes to stderr exclusively — the
+        // stdout data channel (json/yaml/pretty envelopes per #126/#128)
+        // is never touched.
+        let level = "none";
+        if (opts.debug === true) {
+            level = "debug";
+        }
+        else if (opts.verbose === true) {
+            level = "verbose";
+        }
+        setDiagnosticLogger(level);
+        // No-op note for non-mutation leaves: when `--dry-run` is set on a
+        // leaf that has NOT been tagged via `markMutation()` (today: every
+        // command except the basic-update leaf and its top-level alias),
+        // emit the AC-mandated stderr note and proceed normally. The
+        // exact text is locked by the AC for issue #52 — see
+        // `DRY_RUN_NO_OP_STDERR_NOTE` for the constant.
+        //
+        // The note is informational, not blocking — the action handler
+        // runs immediately after this hook returns. Read commands and
+        // unsupported mutations both fall into this branch today; future
+        // mutation-bearing PRs (timesheet submit per #13, additional
+        // profile sub-domain updates per #74-76) MUST call
+        // `markMutation()` on their leaves to opt out of the note.
+        if (dryRun && !isMutationCommand(actionCommand)) {
+            process.stderr.write(DRY_RUN_NO_OP_STDERR_NOTE);
+        }
+    })
+        // Second preAction hook — fires AFTER the sync setup above (Commander
+        // runs registered hooks in order). Async on purpose: the existing
+        // hook stays sync so it pays zero Promise-overhead on the hot path;
+        // the kill-switch fetch (#312) lives in its own hook so the async
+        // boundary is explicit.
+        //
+        // The hook awaits the remote known-broken manifest with a 3s cap.
+        // On match: emits a stderr warning (and exits non-zero when the
+        // entry's `action: "refuse"`). On any failure (network, timeout,
+        // 404, parse error, malformed manifest): silent — fail-silent
+        // contract per #312. Override via `TTCTL_DISABLE_KILL_SWITCH=1`.
+        //
+        // Skipped for `auth init` deliberately? — NO. The bootstrap command
+        // benefits from the warning too: a user creating a fresh config on
+        // a known-broken version should learn before they invest time in
+        // setup. The kill-switch fetch is fail-silent so it cannot block
+        // init's interactive prompts on a network failure.
+        .hook("preAction", async () => {
+        await runKillSwitchAtStartup();
+    });
+    registerAuthCommand(program);
+    program.addCommand(buildProfileCommand());
+    program.addCommand(buildApplicationsCommand());
+    program.addCommand(buildContractsCommand());
+    program.addCommand(buildEngagementsCommand());
+    program.addCommand(buildAvailabilityCommand());
+    program.addCommand(buildJobsCommand());
+    program.addCommand(buildPaymentsCommand());
+    program.addCommand(buildTimesheetCommand());
+    return program;
+}
+/**
+ * Detect whether the leaf command being executed is `auth init`. The
+ * Commander parent chain is `auth init` ← parent `auth` ← parent root —
+ * we walk the chain by name. Used by the global `preAction` hook to
+ * suppress the existence check on the global `--config` flag when the
+ * BOOTSTRAP command is the target. The `auth init` command's own
+ * `--config <path>` flag is the OUTPUT destination, NOT an input config;
+ * the global pre-flight gate would fire incorrectly in that case.
+ */
+function isAuthInitCommand(actionCommand) {
+    if (actionCommand.name() !== "init")
+        return false;
+    const parent = actionCommand.parent;
+    return parent !== null && parent.name() === "auth";
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "@ttctl/cli",
-  "version": "0.0.0",
-  "description": "TTCtl CLI commands and program definition — placeholder reservation; real release in development",
+  "version": "0.1.0-rc.1",
+  "description": "TTCtl CLI commands and program definition",
   "type": "module",
-  "main": "./index.js",
+  "engines": {
+    "node": ">=22.19.0"
+  },
   "license": "AGPL-3.0-only",
   "author": "Alexey Pelykh (https://github.com/alexey-pelykh)",
   "homepage": "https://github.com/alexey-pelykh/ttctl/tree/main/packages/cli",
@@ -11,20 +13,40 @@
   "funding": "https://github.com/sponsors/alexey-pelykh",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alexey-pelykh/ttctl.git",
+    "url": "https://github.com/alexey-pelykh/ttctl.git",
     "directory": "packages/cli"
   },
-  "keywords": [
-    "toptal-talent",
-    "cli",
-    "placeholder"
-  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "files": [
-    "index.js",
-    "README.md",
-    "LICENSE"
+    "dist"
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25",
+    "eslint": "^10.3.0",
+    "typescript": "~6.0.3",
+    "vitest": "^4.1.1"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.3",
+    "yaml": "^2.8.4",
+    "@ttctl/core": "^0.1.0-rc.1"
+  },
+  "scripts": {
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "lint": "eslint src/",
+    "dev": "tsc --watch"
   }
-}
+}

package/index.js

@@ -1,7 +0,0 @@
-// @ttctl/cli placeholder — name reservation only.
-// The real release is in development at https://github.com/alexey-pelykh/ttctl
-console.log(
-  "@ttctl/cli: this is a placeholder reservation, not a functional release.\n" +
-    "The real library is in development. See:\n" +
-    "  https://github.com/alexey-pelykh/ttctl",
-);