@anthusai/papyrus 5.131.0-next.2 → 5.131.0
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.
- package/amplify/functions/automation-view/wire.js +4 -1
- package/amplify/functions/automation-view/wire.ts +4 -1
- package/amplify/functions/image-service/schema.js +10 -0
- package/amplify/functions/image-service/schema.ts +10 -0
- package/amplify/functions/image-service/wire.js +9 -0
- package/amplify/functions/image-service/wire.ts +9 -0
- package/components/announcement-lines.css +26 -0
- package/components/announcement-lines.tsx +157 -0
- package/components/announcement-marks.tsx +36 -0
- package/components/announcements-panel.tsx +10 -34
- package/components/newsroom-article-editor.tsx +4 -0
- package/components/newsroom-organizer.css +1 -1
- package/components/today-view.tsx +45 -0
- package/components/writing-guidelines-admin-panel.tsx +272 -126
- package/lib/announcement-lines.ts +95 -0
- package/lib/announcements-demo.ts +96 -0
- package/lib/announcements-door-client.ts +21 -0
- package/lib/announcements-fixture.ts +1 -19
- package/lib/announcements-model.ts +0 -21
- package/lib/content-actions-demo.ts +2 -0
- package/lib/guidelines/guideline-files.ts +257 -0
- package/lib/guidelines/writing-guidelines-admin.ts +3 -67
- package/lib/images/operations.generated.ts +210 -0
- package/lib/newsroom-articles.ts +5 -0
- package/lib/today-fixture.ts +7 -0
- package/lib/today-overview.ts +40 -0
- package/package.json +7 -2
- package/routes.manifest.json +1 -1
- package/lib/announcements-data.ts +0 -21
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The logic behind Administration > Policies > Writing guidelines, apart from React:
|
|
3
|
-
*
|
|
4
|
-
*
|
|
2
|
+
* The logic behind Administration > Policies > Writing guidelines, apart from React: the types of the guidelines door, how each field of a section's effective
|
|
3
|
+
* guidelines is labelled with where it came from, change lines, and the checks drawn from a set. The files editor itself is `guideline-files.ts`. Nothing here
|
|
4
|
+
* knows how a set is stored: every read and write is one of the `guidelines_*` operations (docs/plans/guidelines-as-data.md section 8).
|
|
5
5
|
*/
|
|
6
6
|
import type { ImageEnvelope, ImageOperationName, ImageOperations } from "../images/operations.generated";
|
|
7
7
|
|
|
@@ -18,73 +18,12 @@ export const NO_REASON_PROBLEM = "Say why you are changing the guidelines. The r
|
|
|
18
18
|
export const NO_WRITING_WARNING = "This publication has no writing guidelines yet, so agents and the editorial checks have no house voice to follow. Write them here.";
|
|
19
19
|
export const EDITORS_READ_ONLY = "You can read the writing guidelines. Only an admin can change them.";
|
|
20
20
|
|
|
21
|
-
export const LIST_FIELDS = [
|
|
22
|
-
{ key: "tone", label: "Tone", hint: "How the writing should sound. One sentence per line." },
|
|
23
|
-
{ key: "sentenceStyle", label: "Sentence style", hint: "How sentences are built. One per line." },
|
|
24
|
-
{ key: "voicePatterns", label: "Voice patterns", hint: "Moves the voice makes, and moves it avoids. One per line." },
|
|
25
|
-
{ key: "structure", label: "Structure", hint: "How a story is laid out. One per line." },
|
|
26
|
-
{ key: "evidenceRules", label: "Evidence rules", hint: "What a claim needs before it is written. One per line." },
|
|
27
|
-
] as const;
|
|
28
|
-
export const CHOICE_FIELDS = [
|
|
29
|
-
{ key: "audience", label: "Audience", hint: "Who the publication writes for." },
|
|
30
|
-
{ key: "editorialAim", label: "Editorial aim", hint: "What the writing is for." },
|
|
31
|
-
] as const;
|
|
32
|
-
export const LOCKABLE_FIELDS: { key: string; label: string }[] = [
|
|
33
|
-
{ key: "voice", label: "Voice" }, { key: "audience", label: "Audience" }, { key: "editorialAim", label: "Editorial aim" }, { key: "headline", label: "Headline" }, { key: "glossary", label: "Glossary" },
|
|
34
|
-
];
|
|
35
21
|
export const FIELD_LABELS: Record<string, string> = {
|
|
36
22
|
voice: "Voice", audience: "Audience", editorialAim: "Editorial aim", headline: "Headline", tone: "Tone", sentenceStyle: "Sentence style", voicePatterns: "Voice patterns",
|
|
37
23
|
structure: "Structure", evidenceRules: "Evidence rules", bodyMarkus: "Guidance in your own words", lexicon: "Words to prefer and avoid", glossary: "Glossary",
|
|
38
24
|
exemplars: "Voice examples", constraints: "Binding rules",
|
|
39
25
|
};
|
|
40
26
|
|
|
41
|
-
export type GlossaryRow = { term: string; use: string; avoid: string };
|
|
42
|
-
export type WritingForm = {
|
|
43
|
-
voiceName: string; audience: string; editorialAim: string; lists: Record<string, string>; prefer: string; avoid: string; bodyMarkus: string;
|
|
44
|
-
glossary: GlossaryRow[]; exemplars: { storyLineageId: string; note: string }[]; locked: string[];
|
|
45
|
-
};
|
|
46
|
-
|
|
47
|
-
export const textLines = (text: string): string[] => text.split("\n").map((line) => line.trim()).filter(Boolean);
|
|
48
|
-
const joinLines = (items: unknown): string => (Array.isArray(items) ? items.filter((item) => typeof item === "string").join("\n") : "");
|
|
49
|
-
const asText = (value: unknown): string => (typeof value === "string" ? value : "");
|
|
50
|
-
|
|
51
|
-
export function formFromDocument(document: GuidelineDocument | null): WritingForm {
|
|
52
|
-
const source = document ?? {};
|
|
53
|
-
return {
|
|
54
|
-
voiceName: asText(source.voice?.name), audience: asText(source.audience), editorialAim: asText(source.editorialAim),
|
|
55
|
-
lists: Object.fromEntries(LIST_FIELDS.map((field) => [field.key, joinLines(source[field.key])])),
|
|
56
|
-
prefer: joinLines(source.lexicon?.prefer), avoid: joinLines(source.lexicon?.avoid), bodyMarkus: asText(source.bodyMarkus),
|
|
57
|
-
glossary: (Array.isArray(source.glossary) ? source.glossary : []).map((entry: any) => ({ term: asText(entry.term), use: asText(entry.use), avoid: joinLines(entry.avoid).split("\n").join(", ") })),
|
|
58
|
-
exemplars: (Array.isArray(source.exemplars) ? source.exemplars : []).map((entry: any) => ({ storyLineageId: asText(entry.storyLineageId), note: asText(entry.note) })),
|
|
59
|
-
locked: Array.isArray(source.locked) ? source.locked.filter((item: unknown) => typeof item === "string") : [],
|
|
60
|
-
};
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
/**
|
|
64
|
-
* The document a form makes. Fields the form does not edit (headline, binding rules, the legacy publication-only fields) are carried over from `base` untouched;
|
|
65
|
-
* a section's document never carries the publication-only fields, so a section form leaves them out. An empty field is left out, never saved empty.
|
|
66
|
-
*/
|
|
67
|
-
export function documentFromForm(form: WritingForm, base: GuidelineDocument | null, scope: "publication" | "section"): GuidelineDocument {
|
|
68
|
-
const document: GuidelineDocument = { ...(base ?? {}), schemaVersion: 2 };
|
|
69
|
-
const setOrDrop = (key: string, value: unknown, present: boolean) => { if (present) document[key] = value; else delete document[key]; };
|
|
70
|
-
setOrDrop("voice", { ...(base?.voice ?? {}), name: form.voiceName.trim() }, form.voiceName.trim() !== "");
|
|
71
|
-
setOrDrop("audience", form.audience.trim(), form.audience.trim() !== "");
|
|
72
|
-
setOrDrop("editorialAim", form.editorialAim.trim(), form.editorialAim.trim() !== "");
|
|
73
|
-
for (const field of LIST_FIELDS) { const lines = textLines(form.lists[field.key] ?? ""); setOrDrop(field.key, lines, lines.length > 0); }
|
|
74
|
-
const prefer = textLines(form.prefer), avoid = textLines(form.avoid);
|
|
75
|
-
setOrDrop("lexicon", { ...(prefer.length ? { prefer } : {}), ...(avoid.length ? { avoid } : {}) }, prefer.length + avoid.length > 0);
|
|
76
|
-
setOrDrop("bodyMarkus", form.bodyMarkus, form.bodyMarkus.trim() !== "");
|
|
77
|
-
const glossary = form.glossary.filter((row) => row.term.trim()).map((row) => ({
|
|
78
|
-
term: row.term.trim(), ...(row.use.trim() ? { use: row.use.trim() } : {}), ...(row.avoid.trim() ? { avoid: row.avoid.split(",").map((word) => word.trim()).filter(Boolean) } : {}),
|
|
79
|
-
}));
|
|
80
|
-
setOrDrop("glossary", glossary, glossary.length > 0);
|
|
81
|
-
const exemplars = form.exemplars.filter((row) => row.storyLineageId).map((row) => ({ storyLineageId: row.storyLineageId, ...(row.note.trim() ? { note: row.note.trim() } : {}) }));
|
|
82
|
-
setOrDrop("exemplars", exemplars, exemplars.length > 0);
|
|
83
|
-
if (scope === "publication") setOrDrop("locked", form.locked, form.locked.length > 0);
|
|
84
|
-
else for (const key of ["locked", "constraints", "publicationKey", "judge", "checks", "density", "rules", "compare", "referenceSamples"]) delete document[key];
|
|
85
|
-
return document;
|
|
86
|
-
}
|
|
87
|
-
|
|
88
27
|
export function reasonProblem(reason: string): string | null {
|
|
89
28
|
return reason.trim() ? null : NO_REASON_PROBLEM;
|
|
90
29
|
}
|
|
@@ -110,9 +49,6 @@ export function describeChange(change: { path: string; from?: unknown; to?: unkn
|
|
|
110
49
|
return `${name}: changed from ${shown(change.from)} to ${shown(change.to)}`;
|
|
111
50
|
}
|
|
112
51
|
|
|
113
|
-
export const addExemplar = (rows: WritingForm["exemplars"], story: PublishedStory): WritingForm["exemplars"] =>
|
|
114
|
-
rows.some((row) => row.storyLineageId === story.lineageId) ? rows : [...rows, { storyLineageId: story.lineageId, note: "" }];
|
|
115
|
-
|
|
116
52
|
export function storyTitle(stories: PublishedStory[], lineageId: string): string {
|
|
117
53
|
return stories.find((story) => story.lineageId === lineageId)?.title ?? lineageId;
|
|
118
54
|
}
|
|
@@ -49,7 +49,11 @@ export type ImageOperationName =
|
|
|
49
49
|
| "announcements_release"
|
|
50
50
|
| "announcements_unlock"
|
|
51
51
|
| "announcements_correct"
|
|
52
|
+
| "announcements_record_manual"
|
|
52
53
|
| "announcements_withdraw"
|
|
54
|
+
| "announcements_where"
|
|
55
|
+
| "announcements_recent"
|
|
56
|
+
| "announcements_explain"
|
|
53
57
|
| "ratings_set"
|
|
54
58
|
;
|
|
55
59
|
|
|
@@ -1293,6 +1297,22 @@ export type AnnouncementsCorrectResult = {
|
|
|
1293
1297
|
id: string;
|
|
1294
1298
|
};
|
|
1295
1299
|
|
|
1300
|
+
/** Record the address of a post a person made by hand for a manual Delivery: the Delivery becomes sent and its attempt names that person. */
|
|
1301
|
+
export type AnnouncementsRecordManualInput = {
|
|
1302
|
+
/** The Delivery's id. */
|
|
1303
|
+
delivery: string;
|
|
1304
|
+
/** The address of the post, an http or https URL. */
|
|
1305
|
+
url: string;
|
|
1306
|
+
};
|
|
1307
|
+
|
|
1308
|
+
export type AnnouncementsRecordManualResult = {
|
|
1309
|
+
id: string;
|
|
1310
|
+
state: string;
|
|
1311
|
+
resultUrl: string;
|
|
1312
|
+
/** The attempt that was written: number, at, outcome, by and url. */
|
|
1313
|
+
attempt: Record<string, unknown>;
|
|
1314
|
+
};
|
|
1315
|
+
|
|
1296
1316
|
/** Withdraw a Delivery that went: this deletes a public post. */
|
|
1297
1317
|
export type AnnouncementsWithdrawInput = {
|
|
1298
1318
|
/** The Delivery's id. */
|
|
@@ -1303,6 +1323,188 @@ export type AnnouncementsWithdrawResult = {
|
|
|
1303
1323
|
id: string;
|
|
1304
1324
|
};
|
|
1305
1325
|
|
|
1326
|
+
/** Where a Story was announced: each Announcement that announces it, with one line for each live Delivery. */
|
|
1327
|
+
export type AnnouncementsWhereInput = {
|
|
1328
|
+
/** The lineage id of the Story. */
|
|
1329
|
+
story: string;
|
|
1330
|
+
};
|
|
1331
|
+
|
|
1332
|
+
export type AnnouncementsWhereResult = {
|
|
1333
|
+
story: string;
|
|
1334
|
+
announcements: ({
|
|
1335
|
+
id: string;
|
|
1336
|
+
kind: string;
|
|
1337
|
+
state: string;
|
|
1338
|
+
releaseAt: string;
|
|
1339
|
+
trigger?: string | null;
|
|
1340
|
+
createdBy?: string | null;
|
|
1341
|
+
/** The version of the Story the Announcement looked at. */
|
|
1342
|
+
versionLookedAt?: number | null;
|
|
1343
|
+
/** The one open review flag for a blocked draft, once for each Announcement: id, words, mark, reason and ask. */
|
|
1344
|
+
reviewFlag?: Record<string, unknown> | null;
|
|
1345
|
+
/** One line for each live Delivery, in channel order. */
|
|
1346
|
+
deliveries: ({
|
|
1347
|
+
/** The Delivery's id. */
|
|
1348
|
+
id: string;
|
|
1349
|
+
announcementId: string;
|
|
1350
|
+
channel: string;
|
|
1351
|
+
accountId: string;
|
|
1352
|
+
generation?: number;
|
|
1353
|
+
/** The Delivery's state. */
|
|
1354
|
+
state: string;
|
|
1355
|
+
/** The state in words, such as Sent or Blocked: check failed. */
|
|
1356
|
+
words: string;
|
|
1357
|
+
/** The Lucide icon of the state. */
|
|
1358
|
+
mark: string;
|
|
1359
|
+
/** The review in words and a mark: words, mark and approval (none, soft or hard). Null for a Delivery that will not go. */
|
|
1360
|
+
approval?: Record<string, unknown> | null;
|
|
1361
|
+
releaseAt?: string | null;
|
|
1362
|
+
lockAt?: string | null;
|
|
1363
|
+
/** The earliest time it is still waiting for. */
|
|
1364
|
+
dueAt?: string | null;
|
|
1365
|
+
waitingFor?: string | null;
|
|
1366
|
+
nextAttemptAt?: string | null;
|
|
1367
|
+
blockedReason?: string | null;
|
|
1368
|
+
/** How many attempts were opened. */
|
|
1369
|
+
attempts: number;
|
|
1370
|
+
/** The last attempt: number, at, outcome, code, words and mark. */
|
|
1371
|
+
lastAttempt?: Record<string, unknown> | null;
|
|
1372
|
+
resultUrl?: string | null;
|
|
1373
|
+
/** What needs a person's eye: Overdue (due, with no attempt), Outcome unknown (an attempt with no answer yet, until Caducus settles it), or a failed check. */
|
|
1374
|
+
attention: ({
|
|
1375
|
+
kind: "overdue" | "outcome_unknown" | "check_failed";
|
|
1376
|
+
words: string;
|
|
1377
|
+
mark: string;
|
|
1378
|
+
/** When it began, as a UTC time. */
|
|
1379
|
+
since?: string;
|
|
1380
|
+
})[];
|
|
1381
|
+
})[];
|
|
1382
|
+
/** In the list: the Stories it is about, each with lineageId and title. */
|
|
1383
|
+
stories?: Record<string, unknown>[];
|
|
1384
|
+
})[];
|
|
1385
|
+
};
|
|
1386
|
+
|
|
1387
|
+
/** The Announcements list: Announcements newest first, one line for each live Delivery, and every Delivery that is overdue. */
|
|
1388
|
+
export type AnnouncementsRecentInput = {
|
|
1389
|
+
/** The size of a page; 25 when left out. A page never splits Announcements released at the same moment. */
|
|
1390
|
+
limit?: number;
|
|
1391
|
+
/** The next value of the last page: shows the Announcements released before that time. */
|
|
1392
|
+
before?: string;
|
|
1393
|
+
};
|
|
1394
|
+
|
|
1395
|
+
export type AnnouncementsRecentResult = {
|
|
1396
|
+
announcements: ({
|
|
1397
|
+
id: string;
|
|
1398
|
+
kind: string;
|
|
1399
|
+
state: string;
|
|
1400
|
+
releaseAt: string;
|
|
1401
|
+
trigger?: string | null;
|
|
1402
|
+
createdBy?: string | null;
|
|
1403
|
+
/** The version of the Story the Announcement looked at. */
|
|
1404
|
+
versionLookedAt?: number | null;
|
|
1405
|
+
/** The one open review flag for a blocked draft, once for each Announcement: id, words, mark, reason and ask. */
|
|
1406
|
+
reviewFlag?: Record<string, unknown> | null;
|
|
1407
|
+
/** One line for each live Delivery, in channel order. */
|
|
1408
|
+
deliveries: ({
|
|
1409
|
+
/** The Delivery's id. */
|
|
1410
|
+
id: string;
|
|
1411
|
+
announcementId: string;
|
|
1412
|
+
channel: string;
|
|
1413
|
+
accountId: string;
|
|
1414
|
+
generation?: number;
|
|
1415
|
+
/** The Delivery's state. */
|
|
1416
|
+
state: string;
|
|
1417
|
+
/** The state in words, such as Sent or Blocked: check failed. */
|
|
1418
|
+
words: string;
|
|
1419
|
+
/** The Lucide icon of the state. */
|
|
1420
|
+
mark: string;
|
|
1421
|
+
/** The review in words and a mark: words, mark and approval (none, soft or hard). Null for a Delivery that will not go. */
|
|
1422
|
+
approval?: Record<string, unknown> | null;
|
|
1423
|
+
releaseAt?: string | null;
|
|
1424
|
+
lockAt?: string | null;
|
|
1425
|
+
/** The earliest time it is still waiting for. */
|
|
1426
|
+
dueAt?: string | null;
|
|
1427
|
+
waitingFor?: string | null;
|
|
1428
|
+
nextAttemptAt?: string | null;
|
|
1429
|
+
blockedReason?: string | null;
|
|
1430
|
+
/** How many attempts were opened. */
|
|
1431
|
+
attempts: number;
|
|
1432
|
+
/** The last attempt: number, at, outcome, code, words and mark. */
|
|
1433
|
+
lastAttempt?: Record<string, unknown> | null;
|
|
1434
|
+
resultUrl?: string | null;
|
|
1435
|
+
/** What needs a person's eye: Overdue (due, with no attempt), Outcome unknown (an attempt with no answer yet, until Caducus settles it), or a failed check. */
|
|
1436
|
+
attention: ({
|
|
1437
|
+
kind: "overdue" | "outcome_unknown" | "check_failed";
|
|
1438
|
+
words: string;
|
|
1439
|
+
mark: string;
|
|
1440
|
+
/** When it began, as a UTC time. */
|
|
1441
|
+
since?: string;
|
|
1442
|
+
})[];
|
|
1443
|
+
})[];
|
|
1444
|
+
/** In the list: the Stories it is about, each with lineageId and title. */
|
|
1445
|
+
stories?: Record<string, unknown>[];
|
|
1446
|
+
})[];
|
|
1447
|
+
/** Every Delivery that is due and has no attempt, read from the sparse due index. */
|
|
1448
|
+
overdue: ({
|
|
1449
|
+
/** The Delivery's id. */
|
|
1450
|
+
id: string;
|
|
1451
|
+
announcementId: string;
|
|
1452
|
+
channel: string;
|
|
1453
|
+
accountId: string;
|
|
1454
|
+
generation?: number;
|
|
1455
|
+
/** The Delivery's state. */
|
|
1456
|
+
state: string;
|
|
1457
|
+
/** The state in words, such as Sent or Blocked: check failed. */
|
|
1458
|
+
words: string;
|
|
1459
|
+
/** The Lucide icon of the state. */
|
|
1460
|
+
mark: string;
|
|
1461
|
+
/** The review in words and a mark: words, mark and approval (none, soft or hard). Null for a Delivery that will not go. */
|
|
1462
|
+
approval?: Record<string, unknown> | null;
|
|
1463
|
+
releaseAt?: string | null;
|
|
1464
|
+
lockAt?: string | null;
|
|
1465
|
+
/** The earliest time it is still waiting for. */
|
|
1466
|
+
dueAt?: string | null;
|
|
1467
|
+
waitingFor?: string | null;
|
|
1468
|
+
nextAttemptAt?: string | null;
|
|
1469
|
+
blockedReason?: string | null;
|
|
1470
|
+
/** How many attempts were opened. */
|
|
1471
|
+
attempts: number;
|
|
1472
|
+
/** The last attempt: number, at, outcome, code, words and mark. */
|
|
1473
|
+
lastAttempt?: Record<string, unknown> | null;
|
|
1474
|
+
resultUrl?: string | null;
|
|
1475
|
+
/** What needs a person's eye: Overdue (due, with no attempt), Outcome unknown (an attempt with no answer yet, until Caducus settles it), or a failed check. */
|
|
1476
|
+
attention: ({
|
|
1477
|
+
kind: "overdue" | "outcome_unknown" | "check_failed";
|
|
1478
|
+
words: string;
|
|
1479
|
+
mark: string;
|
|
1480
|
+
/** When it began, as a UTC time. */
|
|
1481
|
+
since?: string;
|
|
1482
|
+
})[];
|
|
1483
|
+
})[];
|
|
1484
|
+
/** Pass as before for the next page; null on the last page. */
|
|
1485
|
+
next: string | null;
|
|
1486
|
+
};
|
|
1487
|
+
|
|
1488
|
+
/** Why a Story was or was not announced, for each channel, naming the rule. Reads the rules; writes nothing. */
|
|
1489
|
+
export type AnnouncementsExplainInput = {
|
|
1490
|
+
/** The lineage id of the Story. */
|
|
1491
|
+
story: string;
|
|
1492
|
+
};
|
|
1493
|
+
|
|
1494
|
+
export type AnnouncementsExplainResult = {
|
|
1495
|
+
story: string;
|
|
1496
|
+
title?: string;
|
|
1497
|
+
stars?: number;
|
|
1498
|
+
channels: {
|
|
1499
|
+
channel: string;
|
|
1500
|
+
announced: boolean;
|
|
1501
|
+
/** The rule: announced, off, not_published, type_not_announced, section_not_announced, below_bar, below_floor, machine_five, story_not_reviewed, no_delivery or would_announce. */
|
|
1502
|
+
rule: string;
|
|
1503
|
+
words: string;
|
|
1504
|
+
delivery?: string;
|
|
1505
|
+
}[];
|
|
1506
|
+
};
|
|
1507
|
+
|
|
1306
1508
|
/** Give a Story a star rating, 1 to 5. An agent may give only three or four stars, and only to a Story nobody has rated. */
|
|
1307
1509
|
export type RatingsSetInput = {
|
|
1308
1510
|
/** The lineage id of the Story. */
|
|
@@ -1366,7 +1568,11 @@ export interface ImageOperations {
|
|
|
1366
1568
|
announcements_release: { input: AnnouncementsReleaseInput; result: AnnouncementsReleaseResult };
|
|
1367
1569
|
announcements_unlock: { input: AnnouncementsUnlockInput; result: AnnouncementsUnlockResult };
|
|
1368
1570
|
announcements_correct: { input: AnnouncementsCorrectInput; result: AnnouncementsCorrectResult };
|
|
1571
|
+
announcements_record_manual: { input: AnnouncementsRecordManualInput; result: AnnouncementsRecordManualResult };
|
|
1369
1572
|
announcements_withdraw: { input: AnnouncementsWithdrawInput; result: AnnouncementsWithdrawResult };
|
|
1573
|
+
announcements_where: { input: AnnouncementsWhereInput; result: AnnouncementsWhereResult };
|
|
1574
|
+
announcements_recent: { input: AnnouncementsRecentInput; result: AnnouncementsRecentResult };
|
|
1575
|
+
announcements_explain: { input: AnnouncementsExplainInput; result: AnnouncementsExplainResult };
|
|
1370
1576
|
ratings_set: { input: RatingsSetInput; result: RatingsSetResult };
|
|
1371
1577
|
}
|
|
1372
1578
|
|
|
@@ -1418,7 +1624,11 @@ export const IMAGE_OPERATIONS = {
|
|
|
1418
1624
|
announcements_release: { effect: "write", agentAllowed: true, agentRung: "publish_auto", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements release" },
|
|
1419
1625
|
announcements_unlock: { effect: "write", agentAllowed: false, agentRung: "person", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements unlock" },
|
|
1420
1626
|
announcements_correct: { effect: "write", agentAllowed: true, agentRung: "prepare", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements correct" },
|
|
1627
|
+
announcements_record_manual: { effect: "write", agentAllowed: false, agentRung: "person", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements record-manual" },
|
|
1421
1628
|
announcements_withdraw: { effect: "write", agentAllowed: false, agentRung: "person", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements withdraw" },
|
|
1629
|
+
announcements_where: { effect: "read", agentAllowed: true, agentRung: "observe", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements where" },
|
|
1630
|
+
announcements_recent: { effect: "read", agentAllowed: true, agentRung: "observe", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements recent" },
|
|
1631
|
+
announcements_explain: { effect: "read", agentAllowed: true, agentRung: "observe", agentRefusal: "human_required", group: "announcements", command: "papyrus announcements explain" },
|
|
1422
1632
|
ratings_set: { effect: "write", agentAllowed: true, agentRung: "draft", agentRefusal: "human_required", group: "ratings", command: "papyrus ratings set" },
|
|
1423
1633
|
} as const;
|
|
1424
1634
|
|
package/lib/newsroom-articles.ts
CHANGED
|
@@ -11,6 +11,8 @@ import {
|
|
|
11
11
|
createStoryFromReference,
|
|
12
12
|
type ContentActionError,
|
|
13
13
|
} from "./content-actions-client";
|
|
14
|
+
import type { AnnouncementsDoor } from "./announcement-lines";
|
|
15
|
+
import { announcementsDoor } from "./announcements-door-client";
|
|
14
16
|
import { createDemoArticlesBackend } from "./content-actions-demo";
|
|
15
17
|
import { UNTYPED_ITEM_TYPE } from "./content-item-lifecycle";
|
|
16
18
|
import { ALWAYS_PROJECTED, typeForNewStory, siteStoryTypes } from "./site-story-types";
|
|
@@ -111,6 +113,8 @@ export type ArticlesBackend = {
|
|
|
111
113
|
};
|
|
112
114
|
listRows: () => Promise<NewsroomArticleRow[]>;
|
|
113
115
|
loadArticle: (id: string) => Promise<EditableArticle>;
|
|
116
|
+
/** The announcements door (reads only): where the Story was announced, one line for each Delivery. */
|
|
117
|
+
announcementsDoor: AnnouncementsDoor;
|
|
114
118
|
};
|
|
115
119
|
|
|
116
120
|
export function slugify(value: string): string {
|
|
@@ -350,6 +354,7 @@ export function createLiveArticlesBackend(): ArticlesBackend {
|
|
|
350
354
|
actions: { deriveMarkus, saveItemDraft, publishItem, unpublishItem, moveStoryStage, scheduleStory, scheduleList, createStoryFromReference, setItemStars },
|
|
351
355
|
listRows: () => loadArticleRows(dataClient()),
|
|
352
356
|
loadArticle: (id) => loadEditableArticle(dataClient(), id),
|
|
357
|
+
announcementsDoor,
|
|
353
358
|
};
|
|
354
359
|
}
|
|
355
360
|
|
package/lib/today-fixture.ts
CHANGED
|
@@ -48,5 +48,12 @@ export const FIXTURE_TODAY: TodayOverview = {
|
|
|
48
48
|
{ automationId: "digest.weekly", title: "Weekly digest", state: "Did not run", whyCode: "disabled", why: "Disabled: the router starts nothing for a disabled automation" },
|
|
49
49
|
{ automationId: "newsletter.daily", title: "Daily summary", state: "Did not run", whyCode: "no_wake", why: "Nothing woke it today" },
|
|
50
50
|
],
|
|
51
|
+
sends: [
|
|
52
|
+
{
|
|
53
|
+
deliveryId: "announcement-weekly#email#site#g1", announcementId: "announcement-weekly", kind: "roundup", releasedAt: "2026-11-16T13:00:00Z", lists: ["weekly"], items: 5,
|
|
54
|
+
state: "sent", stateShown: "✓ Sent", stateWords: "Sent", attempts: 1, lastAttempt: "sent",
|
|
55
|
+
counts: { queued: 0, sent: 12, failed: 0, suppressed: 1, skipped: 2, delivered: 11, bounced: 1, complained: 0 }, countsText: "12 sent, 1 suppressed, 2 skipped, 11 delivered, 1 bounced", cost: null,
|
|
56
|
+
},
|
|
57
|
+
],
|
|
51
58
|
totals: { runs: 15, counts: { ...none, acted: 8, nothing: 4, asked: 1, failed: 1, unknown: 1 }, costUsd: 0.43, costKnownRuns: 14, costUnknownRuns: 1 },
|
|
52
59
|
};
|
package/lib/today-overview.ts
CHANGED
|
@@ -39,6 +39,29 @@ export type TodayRow = TodayCosts & {
|
|
|
39
39
|
|
|
40
40
|
export type TodayDidNotRun = { automationId: string; title: string; state: "Did not run"; whyCode: "disabled" | "unsupported" | "no_wake"; why: string };
|
|
41
41
|
|
|
42
|
+
export type TodaySendCounts = Record<"queued" | "sent" | "failed" | "suppressed" | "skipped" | "delivered" | "bounced" | "complained", number>;
|
|
43
|
+
|
|
44
|
+
/** One email send: an email Delivery of an Announcement released in the day, with the counts Caducus's records add up to. */
|
|
45
|
+
export type TodaySend = {
|
|
46
|
+
deliveryId: string;
|
|
47
|
+
announcementId: string;
|
|
48
|
+
kind: string;
|
|
49
|
+
releasedAt: string;
|
|
50
|
+
lists: string[];
|
|
51
|
+
items: number;
|
|
52
|
+
state: string;
|
|
53
|
+
/** Where the send stands as a mark and its words, as the command line prints it. */
|
|
54
|
+
stateShown: string;
|
|
55
|
+
/** The same words without the mark: the page draws its own mark (a Lucide icon). */
|
|
56
|
+
stateWords: string;
|
|
57
|
+
attempts: number;
|
|
58
|
+
lastAttempt: string | null;
|
|
59
|
+
counts: TodaySendCounts;
|
|
60
|
+
countsText: string;
|
|
61
|
+
/** What Caducus charged, a decimal string, or null when nothing was charged. */
|
|
62
|
+
cost: string | null;
|
|
63
|
+
};
|
|
64
|
+
|
|
42
65
|
export type TodayOverview = {
|
|
43
66
|
state: "ready";
|
|
44
67
|
asOf: string;
|
|
@@ -48,6 +71,7 @@ export type TodayOverview = {
|
|
|
48
71
|
end: string;
|
|
49
72
|
rows: TodayRow[];
|
|
50
73
|
didNotRun: TodayDidNotRun[];
|
|
74
|
+
sends: TodaySend[];
|
|
51
75
|
totals: TodayCosts & { runs: number; counts: TodayCounts };
|
|
52
76
|
};
|
|
53
77
|
|
|
@@ -65,6 +89,22 @@ export const OTHER_WORDS: Record<"notFinished" | "beforeOutcomes", string> = {
|
|
|
65
89
|
notFinished: "Not finished yet",
|
|
66
90
|
beforeOutcomes: "Recorded before outcomes",
|
|
67
91
|
};
|
|
92
|
+
/** The words of each send count, in the order a send lists them. A count of zero is left out; a send with none says so. */
|
|
93
|
+
export const SEND_COUNT_WORDS: Record<keyof TodaySendCounts, string> = {
|
|
94
|
+
queued: "Queued", sent: "Sent", failed: "Failed", suppressed: "Suppressed", skipped: "Skipped", delivered: "Delivered", bounced: "Bounced", complained: "Complained",
|
|
95
|
+
};
|
|
96
|
+
export const SEND_COUNT_ORDER = Object.keys(SEND_COUNT_WORDS) as (keyof TodaySendCounts)[];
|
|
97
|
+
|
|
98
|
+
export const NO_SEND_COST = "no cost recorded";
|
|
99
|
+
|
|
100
|
+
export function sendCostText(cost: string | null): string {
|
|
101
|
+
return cost === null ? NO_SEND_COST : dollars(Number(cost));
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
export function sendItemsText(items: number): string {
|
|
105
|
+
return `${items} item${items === 1 ? "" : "s"}`;
|
|
106
|
+
}
|
|
107
|
+
|
|
68
108
|
export const OUTCOME_ORDER: TodayOutcome[] = ["acted", "nothing", "asked", "failed", "unknown"];
|
|
69
109
|
export const OTHER_ORDER: ("notFinished" | "beforeOutcomes")[] = ["notFinished", "beforeOutcomes"];
|
|
70
110
|
|
package/package.json
CHANGED
|
@@ -72,6 +72,8 @@
|
|
|
72
72
|
"./components/ai-elements/suggestion": "./components/ai-elements/suggestion.tsx",
|
|
73
73
|
"./components/ai-elements/tool": "./components/ai-elements/tool.tsx",
|
|
74
74
|
"./components/amplify-client-provider": "./components/amplify-client-provider.tsx",
|
|
75
|
+
"./components/announcement-lines": "./components/announcement-lines.tsx",
|
|
76
|
+
"./components/announcement-marks": "./components/announcement-marks.tsx",
|
|
75
77
|
"./components/announcements-panel": "./components/announcements-panel.tsx",
|
|
76
78
|
"./components/archive-grid": "./components/archive-grid.tsx",
|
|
77
79
|
"./components/archive-shell": "./components/archive-shell.tsx",
|
|
@@ -262,8 +264,10 @@
|
|
|
262
264
|
"./lib/amplify-outputs-guard": "./lib/amplify-outputs-guard.ts",
|
|
263
265
|
"./lib/amplify-outputs-path": "./lib/amplify-outputs-path.ts",
|
|
264
266
|
"./lib/amplify-server-runtime": "./lib/amplify-server-runtime.ts",
|
|
267
|
+
"./lib/announcement-lines": "./lib/announcement-lines.ts",
|
|
265
268
|
"./lib/announcements-client": "./lib/announcements-client.ts",
|
|
266
|
-
"./lib/announcements-
|
|
269
|
+
"./lib/announcements-demo": "./lib/announcements-demo.ts",
|
|
270
|
+
"./lib/announcements-door-client": "./lib/announcements-door-client.ts",
|
|
267
271
|
"./lib/announcements-fixture": "./lib/announcements-fixture.ts",
|
|
268
272
|
"./lib/announcements-model": "./lib/announcements-model.ts",
|
|
269
273
|
"./lib/approved-priming-proof-reports": "./lib/approved-priming-proof-reports.ts",
|
|
@@ -328,6 +332,7 @@
|
|
|
328
332
|
"./lib/front-mosaic": "./lib/front-mosaic.ts",
|
|
329
333
|
"./lib/furniture": "./lib/furniture.ts",
|
|
330
334
|
"./lib/graphql-content-repository": "./lib/graphql-content-repository.ts",
|
|
335
|
+
"./lib/guidelines/guideline-files": "./lib/guidelines/guideline-files.ts",
|
|
331
336
|
"./lib/guidelines/guidelines-door-client": "./lib/guidelines/guidelines-door-client.ts",
|
|
332
337
|
"./lib/guidelines/writing-guidelines-admin": "./lib/guidelines/writing-guidelines-admin.ts",
|
|
333
338
|
"./lib/hosted-cyclotron-status": "./lib/hosted-cyclotron-status.ts",
|
|
@@ -645,7 +650,7 @@
|
|
|
645
650
|
"optional": true
|
|
646
651
|
}
|
|
647
652
|
},
|
|
648
|
-
"version": "5.131.0
|
|
653
|
+
"version": "5.131.0",
|
|
649
654
|
"dependencies": {
|
|
650
655
|
"@aws-amplify/adapter-nextjs": "^1.7.3",
|
|
651
656
|
"@aws-crypto/sha256-js": "5.2.0",
|
package/routes.manifest.json
CHANGED
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
import type { AnnouncementRow } from "./announcements-model";
|
|
2
|
-
|
|
3
|
-
/** The announcement backend (PPY-9f4d66) is not in this repository's data API yet. */
|
|
4
|
-
export class AnnouncementsBackendNotDeployed extends Error {
|
|
5
|
-
constructor() {
|
|
6
|
-
super("The announcement list needs the announcement backend (PPY-9f4d66), which is not deployed on this site yet.");
|
|
7
|
-
}
|
|
8
|
-
}
|
|
9
|
-
|
|
10
|
-
export type AnnouncementsSource = { list: () => Promise<AnnouncementRow[]> };
|
|
11
|
-
|
|
12
|
-
/**
|
|
13
|
-
* STUB, named on purpose: the data layer for the dry-run preview and the audit list. When PPY-9f4d66 lands, replace this
|
|
14
|
-
* with the operation behind `papyrus announcements list` (rows carry the Story, state, exact text, link, post id, cost
|
|
15
|
-
* and error, per the plan's audit trail). Until then it fails clearly and the page says so; it never invents rows.
|
|
16
|
-
*/
|
|
17
|
-
export const announcementsSource: AnnouncementsSource = {
|
|
18
|
-
async list() {
|
|
19
|
-
throw new AnnouncementsBackendNotDeployed();
|
|
20
|
-
},
|
|
21
|
-
};
|