@ttctl/cli 0.1.0-rc.6 → 0.1.0-rc.8

package/dist/commands/applications/availability-request.d.ts

@@ -0,0 +1,47 @@
+import { applications } from "@ttctl/core";
+import type { OutputFormat } from "../../lib/output.js";
+/**
+ * Action handler for `ttctl applications availability-request show <id>`
+ * (#442). Read-only fetch of one availability request by id. The id is
+ * the `AvailabilityRequest.id` from `ttctl applications show
+ * <activityId>` output (the `Availability request: <id>` line surfaced
+ * when the activity row has an associated AR) — the same id the
+ * `applications confirm` / `reject` write-side commands take.
+ *
+ * Pretty rendering is a sectioned multi-line block grouped into
+ * Availability request / Comment / Job. Sections with no data (e.g. no
+ * recruiter comment) are omitted.
+ *
+ * `json` / `yaml` always emit the full
+ * {@link applications.AvailabilityRequestDetail} projection — machine
+ * consumers project as needed.
+ */
+export declare function runApplicationsAvailabilityRequestShow(id: string, output: OutputFormat): Promise<void>;
+/**
+ * Render an {@link applications.AvailabilityRequestDetail} as a
+ * sectioned multi-line block. Pure — directly unit-testable.
+ *
+ * Layout:
+ *
+ *     Availability request <id>
+ *       Status:     <status>
+ *       Kind:       <kind>
+ *       Fixed rate: <verbose | $<decimal>/h>     // omitted if fixedRate null
+ *       Created:    <createdAt>
+ *       Updated:    <updatedAt>
+ *       Answered:   <answeredAt>                 // omitted if null (pending)
+ *
+ *     Comment                                    // omitted if comment null/empty
+ *       <recruiter note, paragraph-preserved>
+ *
+ *     Job                                        // omitted if job is null
+ *       Job id: <id>
+ *       Title:  <title>
+ *       URL:    <url>
+ *       Client: <fullName>
+ *
+ * Per-line null guards keep the header concise when the wire returns a
+ * sparse availability request.
+ */
+export declare function formatAvailabilityRequestDetail(item: applications.AvailabilityRequestDetail): string;
+//# sourceMappingURL=availability-request.d.ts.map

package/dist/commands/applications/availability-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability-request.d.ts","sourceRoot":"","sources":["../../../src/commands/applications/availability-request.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sCAAsC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAa5G;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,YAAY,CAAC,yBAAyB,GAAG,MAAM,CA+BpG"}

package/dist/commands/applications/availability-request.js

@@ -0,0 +1,98 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { applications } from "@ttctl/core";
+import { emitResult } from "../../lib/output.js";
+import { formatFixedRate, handleApplicationsError, loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl applications availability-request show <id>`
+ * (#442). Read-only fetch of one availability request by id. The id is
+ * the `AvailabilityRequest.id` from `ttctl applications show
+ * <activityId>` output (the `Availability request: <id>` line surfaced
+ * when the activity row has an associated AR) — the same id the
+ * `applications confirm` / `reject` write-side commands take.
+ *
+ * Pretty rendering is a sectioned multi-line block grouped into
+ * Availability request / Comment / Job. Sections with no data (e.g. no
+ * recruiter comment) are omitted.
+ *
+ * `json` / `yaml` always emit the full
+ * {@link applications.AvailabilityRequestDetail} projection — machine
+ * consumers project as needed.
+ */
+export async function runApplicationsAvailabilityRequestShow(id, output) {
+    const token = await loadAuthTokenOrExit("applications availability-request show", output);
+    let item;
+    try {
+        item = await applications.availabilityRequests.show(token, id);
+    }
+    catch (err) {
+        handleApplicationsError("applications availability-request show", err, output);
+    }
+    emitResult(item, output, {
+        pretty: (data) => formatAvailabilityRequestDetail(data),
+    });
+}
+/**
+ * Render an {@link applications.AvailabilityRequestDetail} as a
+ * sectioned multi-line block. Pure — directly unit-testable.
+ *
+ * Layout:
+ *
+ *     Availability request <id>
+ *       Status:     <status>
+ *       Kind:       <kind>
+ *       Fixed rate: <verbose | $<decimal>/h>     // omitted if fixedRate null
+ *       Created:    <createdAt>
+ *       Updated:    <updatedAt>
+ *       Answered:   <answeredAt>                 // omitted if null (pending)
+ *
+ *     Comment                                    // omitted if comment null/empty
+ *       <recruiter note, paragraph-preserved>
+ *
+ *     Job                                        // omitted if job is null
+ *       Job id: <id>
+ *       Title:  <title>
+ *       URL:    <url>
+ *       Client: <fullName>
+ *
+ * Per-line null guards keep the header concise when the wire returns a
+ * sparse availability request.
+ */
+export function formatAvailabilityRequestDetail(item) {
+    const lines = [];
+    lines.push(`Availability request ${item.id}`);
+    if (item.status !== null)
+        lines.push(`  Status:     ${item.status}`);
+    if (item.kind !== null)
+        lines.push(`  Kind:       ${item.kind}`);
+    if (item.fixedRate !== null)
+        lines.push(`  Fixed rate: ${formatFixedRate(item.fixedRate)}`);
+    if (item.createdAt !== null)
+        lines.push(`  Created:    ${item.createdAt}`);
+    if (item.updatedAt !== null)
+        lines.push(`  Updated:    ${item.updatedAt}`);
+    if (item.answeredAt !== null)
+        lines.push(`  Answered:   ${item.answeredAt}`);
+    if (item.comment !== null && item.comment !== "") {
+        lines.push("");
+        lines.push("Comment");
+        for (const para of item.comment.split(/\n+/)) {
+            if (para.trim().length > 0)
+                lines.push(`  ${para}`);
+        }
+    }
+    if (item.job !== null) {
+        lines.push("");
+        lines.push("Job");
+        lines.push(`  Job id: ${item.job.id}`);
+        if (item.job.title !== null && item.job.title !== "")
+            lines.push(`  Title:  ${item.job.title}`);
+        if (item.job.url !== null && item.job.url !== "")
+            lines.push(`  URL:    ${item.job.url}`);
+        if (item.job.client?.fullName != null && item.job.client.fullName !== "") {
+            lines.push(`  Client: ${item.job.client.fullName}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=availability-request.js.map

package/dist/commands/applications/availability-request.js.map

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

package/dist/commands/applications/confirm.d.ts

@@ -1,14 +1,36 @@
 import { applications } from "@ttctl/core";
 import type { OutputFormat } from "../../lib/output.js";
 /**
- * Options for `ttctl applications confirm <id>` (#411). Mirrors the
- * service-layer {@link applications.ConfirmInput} shape with CLI-side
+ * Options for `ttctl applications confirm <id>` (#411 + #428). Mirrors
+ * the service-layer {@link applications.ConfirmInput} shape with CLI-side
  * argument validation.
+ *
+ * `answersFile` / `pitchFile` (#428) are CLI-only paths (or `-` for
+ * stdin) — the action handler reads + parses the JSON file BEFORE calling
+ * into the service, then forwards the parsed payloads as
+ * `matcherQuestionsAnswers` / `expertiseQuestionsAnswers` / `pitchInput`
+ * (the Stage-1 opaque pass-through; see ADR-008 § Decision Part 3).
  */
 export interface ApplicationsConfirmOptions {
     message?: string;
     rate?: string;
     kind?: applications.AvailabilityRequestKind;
+    /**
+     * Path to a JSON file (or `-` for stdin) containing
+     * `{ matcherAnswers: [...], expertiseAnswers: [...] }` per ADR-008
+     * § Decision Part 2. Parsed payload forwarded as
+     * `matcherQuestionsAnswers` / `expertiseQuestionsAnswers` to the
+     * service. Question identifiers come from `applications show
+     * <activityId>` output.
+     */
+    answersFile?: string;
+    /**
+     * Path to a JSON file (or `-` for stdin) containing a `PitchInput`
+     * object. Parsed payload forwarded as `pitchInput` (note: core field
+     * is `pitchInput`; wire variable is `$pitchInput` mapping to the
+     * mutation's `pitchData` input field — see ADR-008 § Decision Part 2).
+     */
+    pitchFile?: string;
     output: OutputFormat;
 }
 /**
@@ -29,6 +51,14 @@ export interface ApplicationsConfirmOptions {
  * Flexible-kind ARs have no recruiter-pinned rate, so callers MUST
  * pass `--rate <decimal>` when the AR is FLEXIBLE / MARKETPLACE_FLEXIBLE.
  *
+ * Optional `--answers-file <path>` / `--pitch-file <path>` (#428) — see
+ * the option type {@link ApplicationsConfirmOptions} for the file
+ * grammar. Both flags accept `-` to read JSON from stdin per commander
+ * convention; per ADR-008 § Decision Part 2 only one flag may claim
+ * stdin per invocation. Files are read + parsed BEFORE any wire call;
+ * malformed JSON refuses with the `VALIDATION_ERROR` envelope and no
+ * mutation is issued.
+ *
  * **DESTRUCTIVE** — confirming an IR transitions the AR to
  * `AVAILABILITY_REQUEST_CONFIRMED` and creates a `JobApplication`. No
  * withdraw operation is available on the wire. Prefer `--dry-run` to

package/dist/commands/applications/confirm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../../src/commands/applications/confirm.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,YAAY,CAAC,uBAAuB,CAAC;IAC5C,MAAM,EAAE,YAAY,CAAC;CACtB;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDxG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,iCAAiC,GAAG,MAAM,CAcnG"}
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../../src/commands/applications/confirm.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAM3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,YAAY,CAAC,uBAAuB,CAAC;IAC5C;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;CACtB;AA+CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkExG;AA8JD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,iCAAiC,GAAG,MAAM,CAcnG"}

package/dist/commands/applications/confirm.js

@@ -1,10 +1,34 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (C) 2026 Oleksii PELYKH
 import { applications } from "@ttctl/core";
+import { z } from "zod";
 import { getCliDryRun } from "../../lib/dry-run.js";
-import { emitDryRunSuccess, emitUpdateSuccess } from "../../lib/envelopes.js";
+import { emitDryRunSuccess, emitErrorAndExit, emitUpdateSuccess } from "../../lib/envelopes.js";
+import { JsonInputError, parseAsRecovered, readJsonInput } from "../../lib/json-input.js";
 import { handleApplicationsError, loadAuthTokenOrExit } from "./shared.js";
 const DECIMAL_PATTERN = /^\d+(\.\d+)?$/;
+/**
+ * Stage-2 Zod schemas for `--answers-file` payload validation (#438).
+ *
+ * Built ONCE at module load — the factory pattern in
+ * `__generated__/zod-schemas.ts` returns a fresh `z.object(...)` per
+ * call; we materialize each schema once and reuse it across parse
+ * invocations.
+ *
+ * `.strict()` is mandatory at this boundary: codegen emits schemas with
+ * default "strip unknown" semantics, which would silently pass extra
+ * keys. The AC requires "extra unknown key in payload rejected with
+ * field-path error" → wrap each inner schema with `.strict()`.
+ *
+ * Array wrappers (`z.array(...)`) live at the call site so each element
+ * is validated independently; per-entry failures surface their array
+ * index in the field path (`matcherAnswers[2].id: …`).
+ */
+const STRICT_MATCHER_ANSWER_SCHEMA = applications.JobPositionAnswerInputSchema().strict();
+const STRICT_EXPERTISE_ANSWER_SCHEMA = applications.JobExpertiseAnswerInputSchema().strict();
+const STRICT_PITCH_INPUT_SCHEMA = applications.PitchInputSchema().strict();
+const MATCHER_ANSWERS_ARRAY_SCHEMA = z.array(STRICT_MATCHER_ANSWER_SCHEMA);
+const EXPERTISE_ANSWERS_ARRAY_SCHEMA = z.array(STRICT_EXPERTISE_ANSWER_SCHEMA);
 /**
  * Action handler for `ttctl applications confirm <id>` (#411).
  *
@@ -23,6 +47,14 @@ const DECIMAL_PATTERN = /^\d+(\.\d+)?$/;
  * Flexible-kind ARs have no recruiter-pinned rate, so callers MUST
  * pass `--rate <decimal>` when the AR is FLEXIBLE / MARKETPLACE_FLEXIBLE.
  *
+ * Optional `--answers-file <path>` / `--pitch-file <path>` (#428) — see
+ * the option type {@link ApplicationsConfirmOptions} for the file
+ * grammar. Both flags accept `-` to read JSON from stdin per commander
+ * convention; per ADR-008 § Decision Part 2 only one flag may claim
+ * stdin per invocation. Files are read + parsed BEFORE any wire call;
+ * malformed JSON refuses with the `VALIDATION_ERROR` envelope and no
+ * mutation is issued.
+ *
  * **DESTRUCTIVE** — confirming an IR transitions the AR to
  * `AVAILABILITY_REQUEST_CONFIRMED` and creates a `JobApplication`. No
  * withdraw operation is available on the wire. Prefer `--dry-run` to
@@ -42,6 +74,24 @@ export async function runApplicationsConfirm(id, opts) {
     }
     if (opts.kind !== undefined)
         input.kind = opts.kind;
+    // Load + parse answers / pitch JSON BEFORE any wire call (#428). Any
+    // parse / file failure short-circuits with a `VALIDATION_ERROR`
+    // envelope; no mutation is issued. Both flags surface their typed
+    // `JsonInputError` codes through the SAME `VALIDATION_ERROR` envelope
+    // for consistency (the AC pins the envelope code, not the inner
+    // JsonInputError code).
+    if (opts.answersFile !== undefined) {
+        const payload = await loadJsonInputOrExit(opts.answersFile, "answers-file", opts.output);
+        const answers = narrowAnswersPayload(payload, opts.output);
+        if (answers.matcherAnswers !== undefined)
+            input.matcherQuestionsAnswers = answers.matcherAnswers;
+        if (answers.expertiseAnswers !== undefined)
+            input.expertiseQuestionsAnswers = answers.expertiseAnswers;
+    }
+    if (opts.pitchFile !== undefined) {
+        const payload = await loadJsonInputOrExit(opts.pitchFile, "pitch-file", opts.output);
+        input.pitchInput = narrowPitchPayload(payload, opts.output);
+    }
     let outcome;
     try {
         outcome = await applications.confirm(token, id, input, { dryRun });
@@ -71,6 +121,149 @@ export async function runApplicationsConfirm(id, opts) {
         prettyEntity: (data) => formatRespondPayload(data),
     });
 }
+/**
+ * Read + parse a JSON file (or stdin) via {@link readJsonInput}. On any
+ * {@link JsonInputError} surface a structured `VALIDATION_ERROR` envelope
+ * and exit non-zero — the AC pins the envelope code, not the inner
+ * JsonInputError code (which appears in the message instead). Non-Error
+ * throws are re-raised as-is so the outer handler catches them. Returns
+ * the parsed value as `unknown` (Stage-1 opaque pass-through).
+ */
+async function loadJsonInputOrExit(rawPath, flagName, format) {
+    try {
+        return await readJsonInput(rawPath, { flagName });
+    }
+    catch (err) {
+        if (err instanceof JsonInputError) {
+            emitErrorAndExit({
+                operation: "applications.confirm",
+                format,
+                errors: [{ code: "VALIDATION_ERROR", message: err.message, hint: hintForJsonInputCode(err.code) }],
+                prettySummary: `applications confirm failed (VALIDATION_ERROR): ${err.message}`,
+            });
+        }
+        throw err;
+    }
+}
+/**
+ * Map a {@link JsonInputError} code to an actionable recovery hint
+ * surfaced through the `VALIDATION_ERROR` envelope's `hint:` field. The
+ * AC mandates "Recovery hint cites the parse failure line/column" for
+ * `PARSE_ERROR` — the line/column live in the `message` (formatted by
+ * {@link readJsonInput}), so the hint here surfaces the procedural
+ * recovery action.
+ */
+function hintForJsonInputCode(code) {
+    switch (code) {
+        case "FILE_NOT_FOUND":
+            return "Verify the path exists; the absolute path is in the error message.";
+        case "FILE_READ_ERROR":
+            return "Check filesystem permissions on the file (and its parent directory).";
+        case "PARSE_ERROR":
+            return "Fix the JSON syntax at the cited line/column; the file shape should be { matcherAnswers: [...], expertiseAnswers: [...] }.";
+        case "SCHEMA_ERROR":
+            return "Fix the payload to match the recovered shape — matcher answers use { id, answer }; expertise answers use { questionId, other, subjectId }; pitch uses PitchInput.";
+        case "STDIN_UNAVAILABLE":
+            return "Pipe JSON into stdin (e.g. `cat answers.json | ttctl ...`) or pass a file path.";
+        case "STDIN_DOUBLE_CLAIM":
+            return "Only one of --answers-file and --pitch-file may read from stdin per invocation; pass a file path for the other.";
+        default:
+            return "Inspect the input and retry.";
+    }
+}
+/**
+ * Narrow the parsed JSON from `--answers-file` into the
+ * {@link AnswersFilePayload} shape. Surfaces a `VALIDATION_ERROR`
+ * envelope (NOT a wire call) when the top-level wrapper shape is wrong
+ * — e.g. a bare array, a string, or a non-object — OR when the inner
+ * arrays fail the recovered Zod schemas (per #438 Stage-2 tightening).
+ * Each inner schema is wrapped with `.strict()` so extra unknown keys
+ * surface as a field-path Zod issue (e.g. `matcherAnswers[2].questionId:
+ * unrecognized_keys (Unrecognized key(s) in object)`) — the AC's
+ * behavioral scenario 2 "Extra unknown key in payload rejected with
+ * field-path error".
+ */
+function narrowAnswersPayload(payload, format) {
+    if (payload === null || typeof payload !== "object" || Array.isArray(payload)) {
+        emitErrorAndExit({
+            operation: "applications.confirm",
+            format,
+            errors: [
+                {
+                    code: "VALIDATION_ERROR",
+                    message: "--answers-file: expected a JSON object with `matcherAnswers` and/or `expertiseAnswers` arrays.",
+                    hint: "File shape: { matcherAnswers: [...], expertiseAnswers: [...] } — both keys are optional but the top-level value must be an object.",
+                },
+            ],
+            prettySummary: "applications confirm failed (VALIDATION_ERROR): --answers-file shape is not a JSON object.",
+        });
+    }
+    const record = payload;
+    const result = {};
+    if (record["matcherAnswers"] !== undefined) {
+        result.matcherAnswers = validateRecoveredOrExit(record["matcherAnswers"], MATCHER_ANSWERS_ARRAY_SCHEMA, "answers-file:matcherAnswers", format);
+    }
+    if (record["expertiseAnswers"] !== undefined) {
+        result.expertiseAnswers = validateRecoveredOrExit(record["expertiseAnswers"], EXPERTISE_ANSWERS_ARRAY_SCHEMA, "answers-file:expertiseAnswers", format);
+    }
+    return result;
+}
+/**
+ * Narrow the parsed JSON from `--pitch-file` into the `pitchInput`
+ * record shape. Stage-2 (#438): the inner shape is validated against
+ * the recovered `PitchInput` Zod schema (wrapped with `.strict()` so
+ * extra unknown keys reject with a field-path error). Wrong top-level
+ * shape (array / string / null) still surfaces as a CLI-level
+ * `VALIDATION_ERROR` envelope BEFORE the recovered-schema parse runs —
+ * the JSON-object precondition is a precondition of the Zod schema's
+ * `z.object(...)` semantics.
+ */
+function narrowPitchPayload(payload, format) {
+    if (payload === null || typeof payload !== "object" || Array.isArray(payload)) {
+        emitErrorAndExit({
+            operation: "applications.confirm",
+            format,
+            errors: [
+                {
+                    code: "VALIDATION_ERROR",
+                    message: "--pitch-file: expected a JSON object matching the `PitchInput` shape.",
+                    hint: "File shape: a JSON object matching the `PitchInput` schema (see `packages/core/src/__generated__/zod-schemas.ts` § PitchInputSchema).",
+                },
+            ],
+            prettySummary: "applications confirm failed (VALIDATION_ERROR): --pitch-file shape is not a JSON object.",
+        });
+    }
+    return validateRecoveredOrExit(payload, STRICT_PITCH_INPUT_SCHEMA, "pitch-file", format);
+}
+/**
+ * Wrapper around {@link parseAsRecovered} that maps the typed
+ * `SCHEMA_ERROR` from {@link JsonInputError} to the structured
+ * `VALIDATION_ERROR` envelope this command emits. Mirrors
+ * {@link loadJsonInputOrExit} — failure path is uniform across all
+ * input-validation errors (parse, syntax, schema).
+ */
+function validateRecoveredOrExit(value, schema, flagName, format) {
+    try {
+        return parseAsRecovered(value, schema, flagName);
+    }
+    catch (err) {
+        if (err instanceof JsonInputError) {
+            emitErrorAndExit({
+                operation: "applications.confirm",
+                format,
+                errors: [
+                    {
+                        code: "VALIDATION_ERROR",
+                        message: err.message,
+                        hint: hintForJsonInputCode(err.code),
+                    },
+                ],
+                prettySummary: `applications confirm failed (VALIDATION_ERROR): ${err.message}`,
+            });
+        }
+        throw err;
+    }
+}
 /**
  * Render the post-confirm/reject AR projection as the indented entity
  * preview inside the success-update envelope's pretty block. Shared

package/dist/commands/applications/confirm.js.map

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

package/dist/commands/applications/index.d.ts

@@ -10,8 +10,12 @@ import { Command } from "commander";
  * | `show <id>` | Detail view for one row                                  |
  * | `stats`   | Per-status-group counts (5 server calls in parallel)       |
  *
- * Per project non-goals (#15): no apply / withdraw / edit operations
- * are exposed. The CLI is read-only by design.
+ * Write operations on the application funnel are in scope per ADR-008
+ * (ttctl) — `hq/engineering/adr/ADR-008-application-funnel-write-side.md`.
+ * ADR-008 § Decision relaxes the #15 read-only non-goal and bounds the
+ * write surface: Interest Request confirm / reject (shipped in #411)
+ * and direct job application are in scope; `withdraw` / `edit`, bulk
+ * apply, and interview accept / reject remain explicitly out of scope.
  *
  * **Pagination (#377)**: the `list` leaf declares `--page` /
  * `--per-page` (1-indexed positive integers; same `parsePaginationFlag`

package/dist/commands/applications/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/applications/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAgC,MAAM,WAAW,CAAC;AA+BlE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CA8IlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/applications/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAgC,MAAM,WAAW,CAAC;AAqClE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAoRlD"}

package/dist/commands/applications/index.js

@@ -4,7 +4,9 @@ import { Command, InvalidArgumentError, Option } from "commander";
 import { applications } from "@ttctl/core";
 import { OUTPUT_FORMATS } from "../../lib/output.js";
 import { parsePaginationFlag } from "../../lib/pagination.js";
+import { runApplicationsAvailabilityRequestShow } from "./availability-request.js";
 import { runApplicationsConfirm } from "./confirm.js";
+import { runApplicationsInterviewGuideShow, runApplicationsInterviewNotesShow, runApplicationsInterviewShow, } from "./interview.js";
 import { runApplicationsList } from "./list.js";
 import { runApplicationsReject } from "./reject.js";
 import { runApplicationsRejectReasons } from "./reject-reasons.js";
@@ -34,8 +36,12 @@ function perPageOption() {
  * | `show <id>` | Detail view for one row                                  |
  * | `stats`   | Per-status-group counts (5 server calls in parallel)       |
  *
- * Per project non-goals (#15): no apply / withdraw / edit operations
- * are exposed. The CLI is read-only by design.
+ * Write operations on the application funnel are in scope per ADR-008
+ * (ttctl) — `hq/engineering/adr/ADR-008-application-funnel-write-side.md`.
+ * ADR-008 § Decision relaxes the #15 read-only non-goal and bounds the
+ * write surface: Interest Request confirm / reject (shipped in #411)
+ * and direct job application are in scope; `withdraw` / `edit`, bulk
+ * apply, and interview accept / reject remain explicitly out of scope.
  *
  * **Pagination (#377)**: the `list` leaf declares `--page` /
  * `--per-page` (1-indexed positive integers; same `parsePaginationFlag`
@@ -101,15 +107,29 @@ export function buildApplicationsCommand() {
     // the AvailabilityRequest id (NOT the activity-item id) — discover
     // it via `applications show <activityId>` (look for the "Availability
     // request: <id>" line).
+    // #428 — answers-file / pitch-file help text. ADR-008 § Decision
+    // Part 2 locks the JSON-file grammar; per the issue's AC the help
+    // must document the JSON shape (5-line example), the question-id
+    // discovery hint, and the stdin escape.
+    const ANSWERS_FILE_HELP = "JSON file (or `-` for stdin) containing matcher/expertise answers. Shape:\n" +
+        "  {\n" +
+        '    "matcherAnswers": [{"id": "<questionIdentifier>", "answer": "<value>"}],\n' +
+        '    "expertiseAnswers": [{"questionId": "<questionIdentifier>", "other": null, "subjectId": null}]\n' +
+        "  }\n" +
+        "Per the recovered SDL (#438): matcher answers carry the id at `id`; expertise answers carry it at `questionId`. " +
+        "Question identifiers come from `applications show <activityId>` output. Stdin escape: `--answers-file -`.";
+    const PITCH_FILE_HELP = "JSON file (or `-` for stdin) containing the PitchInput payload (single JSON object matching the recovered SDL shape). Stdin escape: `--pitch-file -`.";
     cmd
         .command("confirm")
-        .description("Confirm an Interest Request (DESTRUCTIVE — creates a JobApplication; no undo)")
+        .description("Confirm an Interest Request (DESTRUCTIVE — creates a JobApplication; no undo). See `Interest Requests` in the README for the full workflow.")
         .argument("<id>", "AvailabilityRequest id (NOT the activity-item id)", parseIdArg)
         .option("-m, --message <text>", "optional talent free-text accompanying the confirmation")
         .option("--rate <decimal>", "requested hourly rate (decimal string, e.g. 80.00). Auto-filled from the AR's Fixed rate when omitted; required for FLEXIBLE / MARKETPLACE_FLEXIBLE ARs")
         .addOption(new Option("--kind <kind>", "AR kind (auto-detected from metadata when omitted)").choices([
         ...applications.AVAILABILITY_REQUEST_KINDS,
     ]))
+        .option("--answers-file <path>", ANSWERS_FILE_HELP)
+        .option("--pitch-file <path>", PITCH_FILE_HELP)
         .addOption(new Option("-o, --output <format>", "output format")
         .choices(OUTPUT_FORMATS)
         .default("pretty"))
@@ -121,6 +141,10 @@ export function buildApplicationsCommand() {
             runOpts.rate = options.rate;
         if (options.kind !== undefined)
             runOpts.kind = options.kind;
+        if (options.answersFile !== undefined)
+            runOpts.answersFile = options.answersFile;
+        if (options.pitchFile !== undefined)
+            runOpts.pitchFile = options.pitchFile;
         await runApplicationsConfirm(id, runOpts);
     });
     cmd
@@ -150,6 +174,91 @@ export function buildApplicationsCommand() {
         .action(async (options) => {
         await runApplicationsRejectReasons(options.output);
     });
+    // #439 — Interview detail. Sibling sub-namespace `interview show <id>`
+    // for the rich `TalentInterview` projection (interviewer, scheduled
+    // slot, agenda link, prep-guide ref). The id comes from
+    // `applications show <activityId>` output (the `Interview: <id>`
+    // line). Read-only — no confirm / reject verbs (those remain
+    // out-of-scope per ADR-008 § Decision).
+    const interviewCmd = cmd
+        .command("interview")
+        .description("Interview detail (read-only). See `applications show <activityId>` for the id.");
+    interviewCmd
+        .command("show")
+        .description("Show one interview by id")
+        .argument("<id>", "id of the interview to show", parseIdArg)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runApplicationsInterviewShow(id, options.output);
+    });
+    // #440 — Interview notes (portal-side `GetInterviewNotes`). Sub-sub-
+    // namespace `interview notes show <jobId>` for the talent's prep
+    // notes attached to an interview. Read-only.
+    //
+    // **Input is the JOB id, not the interview id** — the wire op takes
+    // `$jobId: ID!` and traverses
+    // `viewer.job(id).activityItem.interview.{id, kind, talentNotes}`.
+    // Discover the job id via `applications interview show <interviewId>`
+    // (the `Job → Job id` line) or `applications show <activityId>`.
+    const notesCmd = interviewCmd
+        .command("notes")
+        .description("Interview prep notes (read-only). Sub-sub-namespace of `interview`.");
+    notesCmd
+        .command("show")
+        .description("Read the talent's prep notes for the interview attached to a job (input is the JOB id, NOT the interview id)")
+        .argument("<jobId>", "TalentJob id (discover via `applications interview show <interviewId>` → `Job → Job id`)", parseIdArg)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (jobId, options) => {
+        await runApplicationsInterviewNotesShow(jobId, options.output);
+    });
+    // #470 — Interview prep guide (mobile-gateway `InterviewGuide`).
+    // Sub-sub-namespace `interview guide show <interviewId>` for the
+    // interview-prep guide content (sections + tips) attached to one
+    // interview. Read-only.
+    //
+    // Sibling of `notes` — both deepen the `interview` namespace. Input
+    // is the INTERVIEW id (the wire op takes `$interviewId: ID!`).
+    // The `Prep guide → ID: <guideId>` line surfaced by
+    // `applications interview show` is the back-pointer; the guide
+    // CONTENT lives behind this leaf.
+    const guideCmd = interviewCmd
+        .command("guide")
+        .description("Interview prep guide (sections + tips). Sub-sub-namespace of `interview`.");
+    guideCmd
+        .command("show")
+        .description("Read the interview-prep guide content (sections + tips) for one interview")
+        .argument("<interviewId>", "Interview id (discover via `applications interview show <interviewId>` or `applications show <activityId>`)", parseIdArg)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (interviewId, options) => {
+        await runApplicationsInterviewGuideShow(interviewId, options.output);
+    });
+    // #442 — Availability-request detail. Sibling read-only sub-namespace
+    // `availability-request show <id>` for the rich `AvailabilityRequest`
+    // projection (status, kind, recruiter-pinned Fixed rate, recruiter
+    // comment, lifecycle timestamps, job). The `<id>` is the
+    // `AvailabilityRequest.id` from `applications show <activityId>`
+    // output (the `Availability request: <id>` line) — the SAME id the
+    // `confirm` / `reject` write-side leaves accept, NOT the activity-item
+    // id. Read-only — the confirm / reject verbs are the write surface.
+    const availabilityRequestCmd = cmd
+        .command("availability-request")
+        .description("Availability-request detail (read-only). See `applications show <activityId>` for the id.");
+    availabilityRequestCmd
+        .command("show")
+        .description("Show one availability request by id")
+        .argument("<id>", "AvailabilityRequest id (NOT the activity-item id)", parseIdArg)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runApplicationsAvailabilityRequestShow(id, options.output);
+    });
     return cmd;
 }
 /**