@cogenta/agents-builtin 0.6.6 → 0.7.0

package/dist/index.js

@@ -1,3 +1,9 @@
+export { accessibilityAgent } from './accessibility/agent.js';
+export { auditAccessibility, auditContrast, contrastRatio, relativeLuminance, } from './accessibility/audit.js';
+export { analyticsAgent } from './analytics/agent.js';
+export { readAudienceSignals } from './analytics/signals.js';
+export { complianceAgent } from './compliance/agent.js';
+export { auditCompliance } from './compliance/audit.js';
 export { contentAgent } from './content/agent.js';
 export { createContentDraftTool } from './content/provenance.js';
 export { checkTerminology } from './content/terminology.js';
@@ -6,6 +12,12 @@ export { designerAgent } from './designer/agent.js';
 export { developerAgent } from './developer/agent.js';
 export { createCodePatchTool } from './developer/patch-tool.js';
 export { imageCreatorAgent } from './image-creator/agent.js';
+export { mediaAgent } from './media/agent.js';
+export { auditMediaLibrary } from './media/audit.js';
+export { migrationAgent } from './migration/agent.js';
+export { findMigrationResidue, redirectsFor } from './migration/residue.js';
+export { moderationAgent } from './moderation/agent.js';
+export { triageComments } from './moderation/triage.js';
 export { performanceAgent } from './performance/agent.js';
 export { compareToBudget } from './performance/budget.js';
 export { queryCrux } from './performance/crux-client.js';
@@ -40,4 +52,6 @@ export { createProposeThemeTool } from './theme-creator/propose-theme-tool.js';
 export { createListSandboxFilesTool, createReadSandboxFileTool, } from './theme-creator/read-sandbox-tool.js';
 export { COGENTA_THEME_SPECIFICATION } from './theme-creator/theme-spec.js';
 export { createWriteSandboxFileTool } from './theme-creator/write-sandbox-file-tool.js';
+export { translationAgent } from './translation/agent.js';
+export { findTranslationGaps } from './translation/gaps.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAO3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAMrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAS9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAU9D,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAMlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAMnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAEjE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAEnE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAGnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAM7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAA;AAOhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEhE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAStD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAK5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAMhF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAA;AAMtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AAMlF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AAQ9E,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAM3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/media/agent.d.ts

@@ -0,0 +1,10 @@
+import { type AgentDeclaration } from '@cogenta/agents';
+/**
+ * L5 task 10, priority 2. Its findings come from `auditMediaLibrary`, never
+ * from the model: the model writes alt text for the images the audit named,
+ * and nothing else. No delete anywhere in `tools` — "no longer referenced"
+ * is not "no longer wanted", and a file removal is not reversible by the
+ * content trash.
+ */
+export declare const mediaAgent: AgentDeclaration;
+//# sourceMappingURL=agent.d.ts.map

package/dist/media/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/media/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,iBAAiB,CAAA;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,gBAgBvB,CAAA"}

package/dist/media/agent.js

@@ -0,0 +1,26 @@
+import { defineAgent } from '@cogenta/agents';
+/**
+ * L5 task 10, priority 2. Its findings come from `auditMediaLibrary`, never
+ * from the model: the model writes alt text for the images the audit named,
+ * and nothing else. No delete anywhere in `tools` — "no longer referenced"
+ * is not "no longer wanted", and a file removal is not reversible by the
+ * content trash.
+ */
+export const mediaAgent = defineAgent({
+    name: 'media',
+    identity: './identity.md',
+    model: { preferred: 'claude-sonnet', fallback: 'local' },
+    tools: [
+        'media.list',
+        'media.read',
+        'media.write',
+        'content.collections',
+        'content.list',
+        'content.read',
+    ],
+    autonomy: { default: 'propose' },
+    budget: { tokensPerDay: 60_000, eurPerMonth: 4, callsPerHour: 15 },
+    memory: { episodic: true, scope: 'site' },
+    triggers: [{ on: 'schedule', cron: '0 5 * * 1' }],
+});
+//# sourceMappingURL=agent.js.map

package/dist/media/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/media/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAqB,WAAW,CAAC;IACtD,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE;IACxD,KAAK,EAAE;QACL,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,qBAAqB;QACrB,cAAc;QACd,cAAc;KACf;IACD,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;IAChC,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;IAClE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;IACzC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CAClD,CAAC,CAAA"}

package/dist/media/audit.d.ts

@@ -0,0 +1,38 @@
+/**
+ * What is wrong with a media library, computed — never guessed (L5 task 10).
+ *
+ * The rule the priority-1 agents established holds here: the model never
+ * decides *that* something is a problem, only how to word the fix. Every
+ * finding below comes out of arithmetic on real rows, so the same library
+ * always produces the same list, and a test can pin it.
+ */
+export type MediaIssue = 'missing-alt' | 'unused' | 'oversized';
+export interface MediaAuditAsset {
+    readonly id: string;
+    readonly kind: 'image' | 'video' | 'audio' | 'file';
+    readonly filename: string;
+    readonly size: number;
+    readonly width: number | null;
+    readonly height: number | null;
+    readonly alt: string;
+    readonly decorative: boolean;
+    readonly createdAt: string;
+}
+export interface MediaFinding {
+    readonly issue: MediaIssue;
+    readonly id: string;
+    readonly filename: string;
+    /** One sentence, in English like every other agent finding, for the report to translate. */
+    readonly detail: string;
+}
+export interface MediaAuditOptions {
+    /** Ids referenced by at least one entry. Anything outside it is a candidate for `unused`. */
+    readonly referenced: ReadonlySet<string>;
+    /** How old an unreferenced file must be before it counts as unused. A file uploaded an hour ago is simply not placed yet. */
+    readonly unusedAfterDays?: number;
+    /** Bytes per displayed pixel above which an image is oversized. 1 byte/px is already generous for a photograph. */
+    readonly maxBytesPerPixel?: number;
+    readonly now?: Date;
+}
+export declare function auditMediaLibrary(assets: readonly MediaAuditAsset[], options: MediaAuditOptions): readonly MediaFinding[];
+//# sourceMappingURL=audit.d.ts.map

package/dist/media/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/media/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE/D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACxC,6HAA6H;IAC7H,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,mHAAmH;IACnH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CACpB;AAYD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,OAAO,EAAE,iBAAiB,GACzB,SAAS,YAAY,EAAE,CAyCzB"}

package/dist/media/audit.js

@@ -0,0 +1,56 @@
+/**
+ * What is wrong with a media library, computed — never guessed (L5 task 10).
+ *
+ * The rule the priority-1 agents established holds here: the model never
+ * decides *that* something is a problem, only how to word the fix. Every
+ * finding below comes out of arithmetic on real rows, so the same library
+ * always produces the same list, and a test can pin it.
+ */
+const DEFAULT_UNUSED_AFTER_DAYS = 30;
+const DEFAULT_MAX_BYTES_PER_PIXEL = 1;
+const DAY_MS = 24 * 60 * 60 * 1000;
+function daysBetween(from, now) {
+    const at = Date.parse(from);
+    if (Number.isNaN(at))
+        return 0;
+    return (now.getTime() - at) / DAY_MS;
+}
+export function auditMediaLibrary(assets, options) {
+    const now = options.now ?? new Date();
+    const unusedAfter = options.unusedAfterDays ?? DEFAULT_UNUSED_AFTER_DAYS;
+    const maxBytesPerPixel = options.maxBytesPerPixel ?? DEFAULT_MAX_BYTES_PER_PIXEL;
+    const findings = [];
+    for (const asset of assets) {
+        // A decorative image is *meant* to have an empty alt (WCAG): flagging it
+        // would be the false positive that gets an agent muted.
+        if (asset.kind === 'image' && !asset.decorative && asset.alt.trim() === '') {
+            findings.push({
+                issue: 'missing-alt',
+                id: asset.id,
+                filename: asset.filename,
+                detail: 'An image with no alt text: a screen reader announces nothing for it.',
+            });
+        }
+        if (!options.referenced.has(asset.id) && daysBetween(asset.createdAt, now) >= unusedAfter) {
+            findings.push({
+                issue: 'unused',
+                id: asset.id,
+                filename: asset.filename,
+                detail: `No published entry references it, ${Math.floor(daysBetween(asset.createdAt, now))} days after it was uploaded.`,
+            });
+        }
+        if (asset.kind === 'image' && asset.width !== null && asset.height !== null) {
+            const pixels = asset.width * asset.height;
+            if (pixels > 0 && asset.size / pixels > maxBytesPerPixel) {
+                findings.push({
+                    issue: 'oversized',
+                    id: asset.id,
+                    filename: asset.filename,
+                    detail: `${Math.round(asset.size / 1024)} kB for ${asset.width}×${asset.height} pixels — heavier than the picture needs.`,
+                });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=audit.js.map

package/dist/media/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/media/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkCH,MAAM,yBAAyB,GAAG,EAAE,CAAA;AACpC,MAAM,2BAA2B,GAAG,CAAC,CAAA;AACrC,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAElC,SAAS,WAAW,CAAC,IAAY,EAAE,GAAS;IAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAkC,EAClC,OAA0B;IAE1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;IACrC,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAA;IACxE,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,2BAA2B,CAAA;IAChF,MAAM,QAAQ,GAAmB,EAAE,CAAA;IAEnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,yEAAyE;QACzE,wDAAwD;QACxD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3E,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,aAAa;gBACpB,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,sEAAsE;aAC/E,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC;YAC1F,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,QAAQ;gBACf,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,qCAAqC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,8BAA8B;aACzH,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;YACzC,IAAI,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,MAAM,GAAG,gBAAgB,EAAE,CAAC;gBACzD,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,WAAW;oBAClB,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,2CAA2C;iBAC1H,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/migration/agent.d.ts

@@ -0,0 +1,10 @@
+import { type AgentDeclaration } from '@cogenta/agents';
+/**
+ * L5 task 10, priority 3. Works only on entries an import wrote
+ * (`provenance: 'imported'`) — `findMigrationResidue` filters on that — and
+ * never touches a slug: changing an imported URL breaks exactly the links the
+ * migration set out to keep. A redirect it creates is reversible and audited,
+ * like the Site Monitor's (L22 task 3).
+ */
+export declare const migrationAgent: AgentDeclaration;
+//# sourceMappingURL=agent.d.ts.map

package/dist/migration/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/migration/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,iBAAiB,CAAA;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,gBAgB3B,CAAA"}

package/dist/migration/agent.js

@@ -0,0 +1,26 @@
+import { defineAgent } from '@cogenta/agents';
+/**
+ * L5 task 10, priority 3. Works only on entries an import wrote
+ * (`provenance: 'imported'`) — `findMigrationResidue` filters on that — and
+ * never touches a slug: changing an imported URL breaks exactly the links the
+ * migration set out to keep. A redirect it creates is reversible and audited,
+ * like the Site Monitor's (L22 task 3).
+ */
+export const migrationAgent = defineAgent({
+    name: 'migration',
+    identity: './identity.md',
+    model: { preferred: 'claude-sonnet', fallback: 'local' },
+    tools: [
+        'content.collections',
+        'content.schema',
+        'content.list',
+        'content.read',
+        'content.write_draft',
+        'redirects.create',
+    ],
+    autonomy: { default: 'propose' },
+    budget: { tokensPerDay: 60_000, eurPerMonth: 4, callsPerHour: 15 },
+    memory: { episodic: true, scope: 'site' },
+    triggers: [{ on: 'schedule', cron: '0 5 1 * *' }],
+});
+//# sourceMappingURL=agent.js.map

package/dist/migration/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/migration/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqB,WAAW,CAAC;IAC1D,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE;IACxD,KAAK,EAAE;QACL,qBAAqB;QACrB,gBAAgB;QAChB,cAAc;QACd,cAAc;QACd,qBAAqB;QACrB,kBAAkB;KACnB;IACD,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;IAChC,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;IAClE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;IACzC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CAClD,CAAC,CAAA"}

package/dist/migration/residue.d.ts

@@ -0,0 +1,48 @@
+/**
+ * What an import left behind (L5 task 10, Migration).
+ *
+ * `@cogenta/import` (L9) produces a coherent site, not a finished one: links
+ * still point at the old domain, images are still referenced by URL rather
+ * than by media id, excerpts are missing. All four findings below are read
+ * off the stored values — nothing here asks a model whether a link is
+ * internal.
+ */
+export type MigrationIssue = 'absolute-internal-link' | 'orphan-media-url' | 'missing-excerpt' | 'empty-common-field';
+export interface MigrationEntry {
+    readonly id: string;
+    readonly collection: string;
+    readonly title: string;
+    readonly path: string | null;
+    readonly provenance: string;
+    /** Flattened text of the entry — body, blocks, rich text — as the caller extracted it. */
+    readonly text: string;
+    readonly values: Readonly<Record<string, unknown>>;
+}
+export interface MigrationFinding {
+    readonly issue: MigrationIssue;
+    readonly id: string;
+    readonly collection: string;
+    readonly title: string;
+    readonly detail: string;
+    /** For a link finding: the exact URL found, so a redirect can be proposed without re-scanning. */
+    readonly url?: string;
+}
+export interface MigrationOptions {
+    /** Domains the site used to live on. A URL on one of them is an internal link written the old way. */
+    readonly previousDomains: readonly string[];
+    /** Fields most entries of a collection fill; one left empty on an imported entry is a gap worth naming. */
+    readonly excerptFields?: readonly string[];
+}
+export declare function findMigrationResidue(entries: readonly MigrationEntry[], options: MigrationOptions): readonly MigrationFinding[];
+/**
+ * The redirects an import's own links imply: one per distinct old URL whose
+ * path differs from where the entry now lives.
+ *
+ * Mechanical on purpose — a model has nothing to add to "this address moved
+ * there", and `redirects.create` is reversible and audited (L22 task 3).
+ */
+export declare function redirectsFor(findings: readonly MigrationFinding[], entries: readonly MigrationEntry[]): readonly {
+    readonly from: string;
+    readonly to: string;
+}[];
+//# sourceMappingURL=residue.d.ts.map

package/dist/migration/residue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"residue.d.ts","sourceRoot":"","sources":["../../src/migration/residue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GACtB,wBAAwB,GACxB,kBAAkB,GAClB,iBAAiB,GACjB,oBAAoB,CAAA;AAExB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,kGAAkG;IAClG,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,sGAAsG;IACtG,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C,2GAA2G;IAC3G,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3C;AAaD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,OAAO,EAAE,gBAAgB,GACxB,SAAS,gBAAgB,EAAE,CA2C7B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,OAAO,EAAE,SAAS,cAAc,EAAE,GACjC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,CAqB3D"}

package/dist/migration/residue.js

@@ -0,0 +1,92 @@
+/**
+ * What an import left behind (L5 task 10, Migration).
+ *
+ * `@cogenta/import` (L9) produces a coherent site, not a finished one: links
+ * still point at the old domain, images are still referenced by URL rather
+ * than by media id, excerpts are missing. All four findings below are read
+ * off the stored values — nothing here asks a model whether a link is
+ * internal.
+ */
+const URL_PATTERN = /https?:\/\/[^\s"'<>)]+/gu;
+const IMAGE_SUFFIX = /\.(?:jpe?g|png|gif|webp|avif|svg)$/iu;
+function hostOf(url) {
+    try {
+        return new URL(url).host.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+}
+export function findMigrationResidue(entries, options) {
+    const previous = new Set(options.previousDomains.map((domain) => domain.toLowerCase()));
+    const excerptFields = options.excerptFields ?? ['excerpt', 'summary', 'description'];
+    const findings = [];
+    for (const entry of entries) {
+        // Only what an import wrote. An entry someone typed here is not residue,
+        // whatever it contains.
+        if (entry.provenance !== 'imported')
+            continue;
+        for (const url of entry.text.match(URL_PATTERN) ?? []) {
+            const host = hostOf(url);
+            if (host === null || !previous.has(host))
+                continue;
+            findings.push({
+                issue: IMAGE_SUFFIX.test(new URL(url).pathname)
+                    ? 'orphan-media-url'
+                    : 'absolute-internal-link',
+                id: entry.id,
+                collection: entry.collection,
+                title: entry.title,
+                url,
+                detail: IMAGE_SUFFIX.test(new URL(url).pathname)
+                    ? 'An image is still loaded from the old site rather than from this media library.'
+                    : 'A link still points at the old domain rather than at this site.',
+            });
+        }
+        const excerpt = excerptFields
+            .map((field) => entry.values[field])
+            .find((value) => typeof value === 'string' && value.trim() !== '');
+        if (excerpt === undefined && excerptFields.some((field) => field in entry.values)) {
+            findings.push({
+                issue: 'missing-excerpt',
+                id: entry.id,
+                collection: entry.collection,
+                title: entry.title,
+                detail: 'No excerpt: listings and search results will show the first words of the body instead.',
+            });
+        }
+    }
+    return findings;
+}
+/**
+ * The redirects an import's own links imply: one per distinct old URL whose
+ * path differs from where the entry now lives.
+ *
+ * Mechanical on purpose — a model has nothing to add to "this address moved
+ * there", and `redirects.create` is reversible and audited (L22 task 3).
+ */
+export function redirectsFor(findings, entries) {
+    const pathOf = new Map(entries.map((entry) => [entry.id, entry.path]));
+    const seen = new Set();
+    const redirects = [];
+    for (const finding of findings) {
+        if (finding.issue !== 'absolute-internal-link' || finding.url === undefined)
+            continue;
+        const to = pathOf.get(finding.id);
+        if (to === null || to === undefined)
+            continue;
+        let from;
+        try {
+            from = new URL(finding.url).pathname;
+        }
+        catch {
+            continue;
+        }
+        if (from === to || seen.has(from))
+            continue;
+        seen.add(from);
+        redirects.push({ from, to });
+    }
+    return redirects;
+}
+//# sourceMappingURL=residue.js.map

package/dist/migration/residue.js.map

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

package/dist/moderation/agent.d.ts

@@ -0,0 +1,9 @@
+import { type AgentDeclaration } from '@cogenta/agents';
+/**
+ * L5 task 10, priority 2. `triageComments` settles what the site's own
+ * anti-spam pass already settled; the agent explains the rest and leaves it
+ * pending. `comments.decide` cannot delete anything — refusing a comment is
+ * a status a human can reverse.
+ */
+export declare const moderationAgent: AgentDeclaration;
+//# sourceMappingURL=agent.d.ts.map

package/dist/moderation/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/moderation/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,iBAAiB,CAAA;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,gBAS5B,CAAA"}

package/dist/moderation/agent.js

@@ -0,0 +1,18 @@
+import { defineAgent } from '@cogenta/agents';
+/**
+ * L5 task 10, priority 2. `triageComments` settles what the site's own
+ * anti-spam pass already settled; the agent explains the rest and leaves it
+ * pending. `comments.decide` cannot delete anything — refusing a comment is
+ * a status a human can reverse.
+ */
+export const moderationAgent = defineAgent({
+    name: 'moderation',
+    identity: './identity.md',
+    model: { preferred: 'claude-sonnet', fallback: 'local' },
+    tools: ['comments.list', 'comments.decide', 'content.read'],
+    autonomy: { default: 'observe' },
+    budget: { tokensPerDay: 60_000, eurPerMonth: 4, callsPerHour: 15 },
+    memory: { episodic: true, scope: 'site' },
+    triggers: [{ on: 'schedule', cron: '0 * * * *' }],
+});
+//# sourceMappingURL=agent.js.map

package/dist/moderation/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/moderation/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqB,WAAW,CAAC;IAC3D,IAAI,EAAE,YAAY;IAClB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE;IACxD,KAAK,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,cAAc,CAAC;IAC3D,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;IAChC,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;IAClE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;IACzC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CAClD,CAAC,CAAA"}

package/dist/moderation/triage.d.ts

@@ -0,0 +1,24 @@
+import type { CommentSummary, ModeratableStatus } from '@cogenta/agents';
+/**
+ * Which pending comments are already settled by the site's own checks, and
+ * which are a judgement call (L5 task 10, Modération).
+ *
+ * The anti-spam pass of `@cogenta/comments` runs at submission and stores its
+ * verdict. This turns that verdict into decisions an agent may carry out —
+ * and, just as importantly, into the list it must leave alone. A model is
+ * never asked whether something is spam; it is asked to explain the ones the
+ * code could not settle.
+ */
+export interface ModerationDecision {
+    readonly id: string;
+    readonly status: ModeratableStatus;
+    readonly reason: string;
+}
+export interface ModerationTriage {
+    /** Safe to act on: the deterministic verdict is unambiguous. */
+    readonly decided: readonly ModerationDecision[];
+    /** Left pending on purpose — a human (or a model's opinion in the report) decides. */
+    readonly undecided: readonly CommentSummary[];
+}
+export declare function triageComments(comments: readonly CommentSummary[]): ModerationTriage;
+//# sourceMappingURL=triage.d.ts.map

package/dist/moderation/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/moderation/triage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExE;;;;;;;;;GASG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC/C,sFAAsF;IACtF,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;CAC9C;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,gBAAgB,CA0BpF"}

package/dist/moderation/triage.js

@@ -0,0 +1,26 @@
+export function triageComments(comments) {
+    const decided = [];
+    const undecided = [];
+    for (const comment of comments) {
+        if (comment.flagged && comment.severity === 'high') {
+            decided.push({
+                id: comment.id,
+                status: 'spam',
+                reason: `The site's own checks flagged it: ${comment.reason}`,
+            });
+            continue;
+        }
+        if (!comment.flagged) {
+            decided.push({
+                id: comment.id,
+                status: 'approved',
+                reason: "The site's own checks found nothing wrong with it.",
+            });
+            continue;
+        }
+        // Flagged, but not squarely: exactly the case a moderator exists for.
+        undecided.push(comment);
+    }
+    return { decided, undecided };
+}
+//# sourceMappingURL=triage.js.map

package/dist/moderation/triage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.js","sourceRoot":"","sources":["../../src/moderation/triage.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,cAAc,CAAC,QAAmC;IAChE,MAAM,OAAO,GAAyB,EAAE,CAAA;IACxC,MAAM,SAAS,GAAqB,EAAE,CAAA;IAEtC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,qCAAqC,OAAO,CAAC,MAAM,EAAE;aAC9D,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,oDAAoD;aAC7D,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QACD,sEAAsE;QACtE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAA;AAC/B,CAAC"}

package/dist/translation/agent.d.ts

@@ -0,0 +1,9 @@
+import { type AgentDeclaration } from '@cogenta/agents';
+/**
+ * L5 task 10, priority 2. `findTranslationGaps` decides what is missing or
+ * behind; the model only translates what it was handed, into a draft. No
+ * `content.publish`: which language a site speaks in public is an editorial
+ * decision, and ADR-0014 makes each translation a real entry someone owns.
+ */
+export declare const translationAgent: AgentDeclaration;
+//# sourceMappingURL=agent.d.ts.map

package/dist/translation/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/translation/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,iBAAiB,CAAA;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAe7B,CAAA"}

package/dist/translation/agent.js

@@ -0,0 +1,24 @@
+import { defineAgent } from '@cogenta/agents';
+/**
+ * L5 task 10, priority 2. `findTranslationGaps` decides what is missing or
+ * behind; the model only translates what it was handed, into a draft. No
+ * `content.publish`: which language a site speaks in public is an editorial
+ * decision, and ADR-0014 makes each translation a real entry someone owns.
+ */
+export const translationAgent = defineAgent({
+    name: 'translation',
+    identity: './identity.md',
+    model: { preferred: 'claude-sonnet', fallback: 'local' },
+    tools: [
+        'content.collections',
+        'content.schema',
+        'content.list',
+        'content.read',
+        'content.write_draft',
+    ],
+    autonomy: { default: 'propose' },
+    budget: { tokensPerDay: 60_000, eurPerMonth: 4, callsPerHour: 15 },
+    memory: { episodic: true, scope: 'site' },
+    triggers: [{ on: 'schedule', cron: '0 5 * * 2' }],
+});
+//# sourceMappingURL=agent.js.map

package/dist/translation/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/translation/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEpE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqB,WAAW,CAAC;IAC5D,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,eAAe;IACzB,KAAK,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE;IACxD,KAAK,EAAE;QACL,qBAAqB;QACrB,gBAAgB;QAChB,cAAc;QACd,cAAc;QACd,qBAAqB;KACtB;IACD,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;IAChC,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;IAClE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE;IACzC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CAClD,CAAC,CAAA"}

package/dist/translation/gaps.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Which translations are missing, and which have fallen behind (L5 task 10).
+ *
+ * ADR-0014 makes a translation a real entry of its own, linked by
+ * `translationOf`. That is what makes both questions answerable by arithmetic:
+ * a family is a set of entries with a locale each, and a member is stale when
+ * it was last written before its source was.
+ */
+export type TranslationIssue = 'missing' | 'stale';
+export interface TranslationMember {
+    readonly id: string;
+    readonly locale: string;
+    readonly updatedAt: string;
+    readonly title: string;
+}
+export interface TranslationFamily {
+    readonly collection: string;
+    /** The entry the others are translations of. */
+    readonly source: TranslationMember;
+    readonly members: readonly TranslationMember[];
+}
+export interface TranslationGap {
+    readonly issue: TranslationIssue;
+    readonly collection: string;
+    readonly sourceId: string;
+    readonly title: string;
+    readonly locale: string;
+    readonly detail: string;
+}
+export declare function findTranslationGaps(families: readonly TranslationFamily[], locales: readonly string[]): readonly TranslationGap[];
+//# sourceMappingURL=gaps.d.ts.map

package/dist/translation/gaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gaps.d.ts","sourceRoot":"","sources":["../../src/translation/gaps.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAA;AAElD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAC/C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,EACtC,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,SAAS,cAAc,EAAE,CAoC3B"}

package/dist/translation/gaps.js

@@ -0,0 +1,44 @@
+/**
+ * Which translations are missing, and which have fallen behind (L5 task 10).
+ *
+ * ADR-0014 makes a translation a real entry of its own, linked by
+ * `translationOf`. That is what makes both questions answerable by arithmetic:
+ * a family is a set of entries with a locale each, and a member is stale when
+ * it was last written before its source was.
+ */
+export function findTranslationGaps(families, locales) {
+    const gaps = [];
+    for (const family of families) {
+        const byLocale = new Map(family.members.map((member) => [member.locale, member]));
+        byLocale.set(family.source.locale, family.source);
+        for (const locale of locales) {
+            if (locale === family.source.locale)
+                continue;
+            const member = byLocale.get(locale);
+            if (member === undefined) {
+                gaps.push({
+                    issue: 'missing',
+                    collection: family.collection,
+                    sourceId: family.source.id,
+                    title: family.source.title,
+                    locale,
+                    detail: `No ${locale} version of this entry exists.`,
+                });
+                continue;
+            }
+            // Strictly before: same instant means translated in the same edit.
+            if (Date.parse(member.updatedAt) < Date.parse(family.source.updatedAt)) {
+                gaps.push({
+                    issue: 'stale',
+                    collection: family.collection,
+                    sourceId: family.source.id,
+                    title: family.source.title,
+                    locale,
+                    detail: `The ${locale} version was last written before the source was changed.`,
+                });
+            }
+        }
+    }
+    return gaps;
+}
+//# sourceMappingURL=gaps.js.map

package/dist/translation/gaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gaps.js","sourceRoot":"","sources":["../../src/translation/gaps.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2BH,MAAM,UAAU,mBAAmB,CACjC,QAAsC,EACtC,OAA0B;IAE1B,MAAM,IAAI,GAAqB,EAAE,CAAA;IAEjC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;QACjF,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAEjD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM;gBAAE,SAAQ;YAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC;oBACR,KAAK,EAAE,SAAS;oBAChB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE;oBAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;oBAC1B,MAAM;oBACN,MAAM,EAAE,MAAM,MAAM,gCAAgC;iBACrD,CAAC,CAAA;gBACF,SAAQ;YACV,CAAC;YACD,mEAAmE;YACnE,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvE,IAAI,CAAC,IAAI,CAAC;oBACR,KAAK,EAAE,OAAO;oBACd,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE;oBAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;oBAC1B,MAAM;oBACN,MAAM,EAAE,OAAO,MAAM,0DAA0D;iBAChF,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}