@formigio/fazemos-cli 0.10.60 → 0.10.62

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,58 @@
1
+ /**
2
+ * F52 — Email Ingest Phase B: unified `ingest` CLI command group.
3
+ *
4
+ * Exports `registerIngestCommands(program)` which wires the following
5
+ * subcommand surface under `fazemos ingest`:
6
+ *
7
+ * ── Merged from F51 (formerly `email-ingest`, group renamed → `ingest`) ──────
8
+ *
9
+ * sender-map — ADD / LIST / REMOVE sender → project routing rules
10
+ * personas — LIST ingest personas (shared inbound addresses)
11
+ * holds — LIST / SHOW / RESOLVE / DROP held-ambiguous emails
12
+ *
13
+ * fazemos ingest sender-map add <email> --project <slug> [--note <text>]
14
+ * fazemos ingest sender-map list [--project <slug>]
15
+ * fazemos ingest sender-map remove <id>
16
+ * fazemos ingest personas list
17
+ * fazemos ingest holds list [--persona <local-part>]
18
+ * fazemos ingest holds show <id>
19
+ * fazemos ingest holds resolve <id> --project <slug>
20
+ * fazemos ingest holds drop <id> --reason <text>
21
+ *
22
+ * ── New in F52 ────────────────────────────────────────────────────────────────
23
+ *
24
+ * project — Per-project intake configuration (intake worksheet + status)
25
+ *
26
+ * fazemos ingest project set-intake [--project <slug>] --worksheet <ws_id>
27
+ * → PUT /api/email-ingest/projects/:projectId/intake {worksheet_id}
28
+ * Sets the intake worksheet destination for inbound email. Requires
29
+ * owner/admin. Resolves project slug → UUID via the F15 resolution chain.
30
+ *
31
+ * fazemos ingest project show [--project <slug>]
32
+ * → GET /api/email-ingest/projects/:projectId/intake
33
+ * Shows the current intake worksheet and known-sender count for the project.
34
+ *
35
+ * Note: the CLI group is renamed `ingest` (from F51's `email-ingest`). The
36
+ * underlying API route prefix `/api/email-ingest/…` is UNCHANGED — do NOT
37
+ * rename the API routes. Only the CLI verb changes.
38
+ *
39
+ * Auth: all commands require a valid Cognito session and org owner/admin role.
40
+ * Server enforces the role gate; the CLI surfaces 401/403 errors clearly.
41
+ * Agent identities (fzm_ / fzx_ API keys) are blocked server-side.
42
+ *
43
+ * Spec: F52-email-ingest-client-message-agent-triage-tech-spec.md §7, §10
44
+ * Merged: F51-email-ingest-mvp branch feature/F51-email-ingest-mvp@6a80015
45
+ */
46
+ import type { Command } from 'commander';
47
+ /**
48
+ * Register the unified `ingest` command group under the root program.
49
+ *
50
+ * Sub-groups:
51
+ * sender-map (F51 merge-forward, renamed from email-ingest)
52
+ * personas (F51 merge-forward, renamed from email-ingest)
53
+ * holds (F51 merge-forward, renamed from email-ingest)
54
+ * project (F52-native: set-intake, show)
55
+ *
56
+ * Invoke from src/index.ts after the other registerXxxCommands() calls.
57
+ */
58
+ export declare function registerIngestCommands(program: Command): void;