commandmate 0.46.1 → 0.47.2

package/dist/server/src/lib/polling/auto-yes-confirmation-ledger-types.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * The vocabulary of the Auto-Yes confirmation ledger's log lines, for every
+ * path (Issue #3820, design `docs/design/auto-yes-measurement-3820.md` §3.3).
+ *
+ * Fixed here, in PR 1, for all of them: the poller (screen) writes its lines
+ * now; the hook route, the API adjudication and `/prompt-response` (PR 2) and
+ * the agy link (PR 3) write theirs through the same ledger later, and the daily
+ * aggregation (PR 4) reads all of them. A line is fixed-size on purpose: codes
+ * and ids only — never a question, a command or a path — and no arrays except
+ * `segments`, whose length is bounded by the number of paths.
+ *
+ * Types and constants only, so a reader (the aggregation, tests) can import it
+ * without the ledger's state or its logger.
+ *
+ * @module lib/polling/auto-yes-confirmation-ledger-types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_PERMISSION_MODES = exports.HOOK_ABSTAIN_REASONS = exports.CONFIRMATION_RESOLVED_BY = exports.CONFIRMATION_RESOLUTIONS = exports.ATTEMPT_RESULTS = exports.LEDGER_WITHHOLD_REASONS = exports.ANSWER_BASES = exports.AUTO_YES_LEDGER_PATHS = exports.AUTO_YES_LEDGER_EVENTS = exports.AUTO_YES_LEDGER_LOG_MODULE = exports.AUTO_YES_LEDGER_VERSION = void 0;
+/** The version of this vocabulary, on every line (`ledgerVersion`). */
+exports.AUTO_YES_LEDGER_VERSION = 1;
+/** The log module every ledger line is written under (`[time] [INFO] [<module>] <event> {json}`). */
+exports.AUTO_YES_LEDGER_LOG_MODULE = 'auto-yes-confirmation-ledger';
+/** The ledger's log line names (design §3.3). */
+exports.AUTO_YES_LEDGER_EVENTS = {
+    started: 'auto-yes-ledger-started',
+    alive: 'auto-yes-ledger-alive',
+    opened: 'auto-yes-confirmation-opened',
+    withholdStarted: 'auto-yes-withhold-started',
+    withholdReasonChanged: 'auto-yes-withhold-reason-changed',
+    withholdEnded: 'auto-yes-withhold-ended',
+    attemptSettled: 'auto-yes-confirmation-attempt-settled',
+    presenceChanged: 'auto-yes-confirmation-presence-changed',
+    checkpoint: 'auto-yes-confirmation-checkpoint',
+    closed: 'auto-yes-confirmation-closed',
+    /** PR 2: written by the hook route only — the API adjudication never makes a hook request. */
+    hookRequestClosed: 'auto-yes-hook-request-closed',
+    /**
+     * PR 3: the call a hook request asked about ended (agy's `PostToolUse`) and
+     * no confirmation on screen was ever tied to it. Written after the request's
+     * own line, which closed when its reply was written (design §2.6).
+     */
+    hookRequestDialogUnobserved: 'auto-yes-hook-request-dialog-unobserved',
+    /** PR 2. */
+    cliModeObserved: 'auto-yes-cli-mode-observed',
+};
+// =============================================================================
+// The vocabulary as values, for a reader that must tell a known code from
+// anything else (the daily aggregation, PR 4, folds the rest into `(other)`).
+// Each list is the keys of a `Record` over its union, so the compiler fails
+// when a member is added to the union and not here, or the other way round.
+// =============================================================================
+const PATHS = {
+    screen: true,
+    hook: true,
+    api: true,
+    'prompt-response': true,
+    'agy-link': true,
+};
+/** Every {@link AutoYesLedgerPath}, in the order the PRs add them (design §6.4). */
+exports.AUTO_YES_LEDGER_PATHS = Object.keys(PATHS);
+const BASES = { L1: true, L2: true, L3: true, L4: true, 'enter-fallback': true, browser: true, human: true };
+exports.ANSWER_BASES = Object.keys(BASES);
+const WITHHOLD_REASONS = {
+    'mode-off': true,
+    'deny-pattern': true,
+    'deny-pattern-unusable': true,
+    'type-not-allowed': true,
+    'policy-lookup-failed': true,
+    'agent-launch-dialog': true,
+    'unclassified-frame': true,
+    'partial-answer': true,
+    'startup-trust-unhandled': true,
+    'question-confirm-page': true,
+    'no-hook-receipt': true,
+    'send-failed': true,
+    'send-no-keys': true,
+    'foreign-session': true,
+    'moved-send-in-flight': true,
+    'answered-recently': true,
+};
+exports.LEDGER_WITHHOLD_REASONS = Object.keys(WITHHOLD_REASONS);
+const RESULTS = { ok: true, partial: true, 'no-keys-sent': true, failed: true };
+exports.ATTEMPT_RESULTS = Object.keys(RESULTS);
+const RESOLUTIONS = {
+    'resolved-after-answer': true,
+    'resolved-while-withheld': true,
+    'resolved-by-reply': true,
+    'resolved-before-decision': true,
+    'unresolved-after-send': true,
+    'gone-while-unobservable': true,
+    abandoned: true,
+};
+exports.CONFIRMATION_RESOLUTIONS = Object.keys(RESOLUTIONS);
+const RESOLVED_BY = { auto: true, 'human-ui': true, unknown: true };
+exports.CONFIRMATION_RESOLVED_BY = Object.keys(RESOLVED_BY);
+/**
+ * Why the hook route answered a request with no decision (PR 2's
+ * `abstainReason`): `PermissionDecisionReason` (`hooks/permission-decision-service.ts`)
+ * less `auto-yes`, the one reason that is a decision (design §2.3).
+ */
+exports.HOOK_ABSTAIN_REASONS = [
+    'unknown-payload',
+    'ask-user-question',
+    'auto-yes-disabled',
+    'policy-suppressed',
+    'worktree-unresolved',
+];
+/**
+ * The `permission_mode` values claude's `PermissionRequest` is known to carry
+ * (PR 2's `cli-mode-observed`). Another value is still logged as it came; the
+ * daily aggregation counts it as `(other)` (design §6.1).
+ */
+exports.CLI_PERMISSION_MODES = ['default', 'acceptEdits', 'plan', 'bypassPermissions'];