@cogenta/cli 0.3.0 → 0.6.0

package/dist/commands/assistant.d.ts

@@ -1,6 +1,6 @@
-import { type AssistToolset, type EmbeddingProvider, type SemanticSearch, type VectorStore } from '@cogenta/agents';
-import type { CogentaConfig, DatabaseHandle, Logger } from '@cogenta/core';
-import type { CollectionDefinition, ContentStore, SearchDriver } from '@cogenta/schema';
+import { type AssistToolset, type EmbeddingProvider, type PromptTemplateStore, type ReferenceDocumentRecord, type SemanticSearch, type VectorStore } from '@cogenta/agents';
+import { type CogentaConfig, type DatabaseHandle, type Logger } from '@cogenta/core';
+import type { CollectionDefinition, ContentStore, SearchDriver, SiteSettingsStore } from '@cogenta/schema';
 /**
  * Where L18 is actually wired into a running site.
  *
@@ -16,6 +16,49 @@ import type { CollectionDefinition, ContentStore, SearchDriver } from '@cogenta/
  * not a refusal to start. Nothing in this file can prevent `cogenta serve` from
  * serving a site (R2).
  */
+/** One collection's place in the vector index — L22 task 4's "quelles collections, activable/désactivable par collection". */
+export interface AssistantIndexedCollection {
+    readonly name: string;
+    /** `false` when an operator has explicitly excluded this collection (`assistant.indexedCollections`) — the explicit ask being able to turn off e.g. published articles. Absent from the setting means enabled: an install that has never touched this toggle indexes everything, as it always has. */
+    readonly enabled: boolean;
+    /** How many chunks of this collection are in the index right now — independent of `enabled`, since a toggle flipped off leaves old chunks in place until a reindex (`cogenta serve`'s "Reindex vectors" tool) sweeps them out. */
+    readonly count: number;
+}
+/**
+ * What the vector index looks like right now — fiche 30 task 6, "l'index
+ * vectoriel est invisible", widened by L22 task 4 to explain *what is in it*
+ * rather than only how big it is. `count`/`lastIndexedAt`/`collections` are
+ * read on demand, never cached beyond the process, so the admin panel is
+ * never stale by more than one request.
+ */
+export interface AssistantVectorInfo {
+    readonly driver: string;
+    readonly dimensions: number;
+    count(): Promise<number>;
+    lastIndexedAt(): string | null;
+    /** `withVectorIndexing` calls this after each successful write — not exported for anything else to call. */
+    noteIndexed(): void;
+    /** Every content collection this site has, each with its toggle state and its current chunk count. */
+    collections(): Promise<readonly AssistantIndexedCollection[]>;
+    /** The reserved pseudo-collection name uploaded reference documents are stored under — `assist.chat`'s `collections` input names it to retrieve them. Exposed so the admin never has to hard-code it. */
+    readonly referenceCollection: string;
+}
+/**
+ * The document upload flow, L22 task 4 — wired onto the existing
+ * `document.extract_text` → `chunkDocument` → `EmbeddingProvider.embed`
+ * pipeline (L19/L18) rather than a second one. Absent under exactly the
+ * condition `vectors` is: no embedder, nothing to embed an upload into.
+ */
+export interface AssistantDocumentService {
+    list(): Promise<readonly ReferenceDocumentRecord[]>;
+    /** Extracts, chunks, embeds and stores one document; never throws on a bad upload — the returned record's own `status`/`errorMessage` says what happened. */
+    upload(input: {
+        readonly filename: string;
+        readonly bytes: Buffer;
+        readonly uploadedBy: string | null;
+    }): Promise<ReferenceDocumentRecord>;
+    remove(id: string): Promise<void>;
+}
 export interface AssistantAssembly {
     readonly toolset: AssistToolset;
     /** Absent when semantic search is not available on this site. */
@@ -24,7 +67,13 @@ export interface AssistantAssembly {
     readonly vectors?: {
         readonly store: VectorStore;
         readonly embeddings: EmbeddingProvider;
+        /** Reads live, per collection, whether it belongs in the index — shared by the write path (`withVectorIndexing`) and the bulk "Reindex vectors" tool, so both honour the same toggle. */
+        readonly isEnabled: (collectionName: string) => Promise<boolean>;
     };
+    /** Absent when there is no vector store at all — same condition as `vectors`, but the toolset already has its own view of driver/dimensions so this is not derived from it. */
+    readonly vectorInfo?: AssistantVectorInfo;
+    /** Absent under the same condition as `vectors` — nothing to embed an uploaded document into. */
+    readonly documents?: AssistantDocumentService;
     /** What `cogenta serve` prints on startup. Always truthful about what is off. */
     readonly summary: string;
     dispose(): Promise<void>;
@@ -35,7 +84,20 @@ export interface BuildAssistantOptions {
     readonly logger: Logger;
     /** L10's full-text index, fused with the vector half rather than replaced by it. */
     readonly fullText?: SearchDriver;
+    /** Every content collection this site declares — needed to report per-collection index state (L22 task 4). */
+    readonly collections: readonly CollectionDefinition[];
+    /** Backs the `assistant.indexedCollections` per-collection toggle and identifies the site for reference-document rows. */
+    readonly settings: SiteSettingsStore;
+    readonly siteId: string;
+    /** Fiche 45 — shared with `buildAgentRuntime`'s own instance over the same on-disk directory. Absent means every `assist.*` tool keeps its hard-coded instruction text, unchanged (R2/fiche 45 §4). */
+    readonly promptTemplates?: PromptTemplateStore;
 }
+/**
+ * Reads the live toggle for one collection. Exported so `cogenta serve`'s
+ * "Reindex vectors" tool body (`tools.ts`) can honour the exact same
+ * predicate the write path uses, rather than a second copy of this read.
+ */
+export declare function isAssistantCollectionEnabled(settings: SiteSettingsStore, collectionName: string): Promise<boolean>;
 export declare function buildAssistant(options: BuildAssistantOptions): Promise<AssistantAssembly>;
 /**
  * Keeps the vector index in step with the content, by wrapping the store.
@@ -60,6 +122,30 @@ export interface VectorIndexingOptions {
     readonly store: VectorStore;
     readonly embeddings: EmbeddingProvider;
     readonly onError?: (error: unknown) => void;
+    /** Fiche 30 task 6's "dernière indexation" — called once per successful reindex (upsert or removal alike), never on failure. */
+    readonly onIndexed?: () => void;
+    /**
+     * L22 task 4's per-collection toggle. Read live on every write and by the
+     * bulk "Reindex vectors" tool — never cached, so a toggle flipped from the
+     * admin takes effect on the very next save without a restart. Absent means
+     * "always enabled", which keeps every site that predates this toggle
+     * indexing exactly as it always has.
+     */
+    readonly isEnabled?: (collectionName: string) => Promise<boolean>;
 }
+/**
+ * Re-derives the indexed vector chunk(s) for one entry. Exported so a full
+ * rebuild (`reindexAllVectors`, and the "Reindex vectors" tool, fiche 24 task
+ * 3) reuses exactly what the write path does on every save, rather than a
+ * second copy of the published-only rule this indexer enforces.
+ */
+export declare function reindexVectorEntry(store: ContentStore, options: VectorIndexingOptions, id: string): Promise<void>;
+/**
+ * Walks every entry of a collection and re-derives its vector chunk. Unlike
+ * search's `reindexAll`, only the published face is ever indexed (see the
+ * doc comment on `recordFor`'s caller above) — a trashed-but-published entry
+ * is still indexed, since trash is orthogonal to `status` (ADR-0022).
+ */
+export declare function reindexAllVectors(store: ContentStore, options: VectorIndexingOptions, onProgress?: (count: number) => void): Promise<number>;
 export declare function withVectorIndexing(store: ContentStore, options: VectorIndexingOptions): ContentStore;
 //# sourceMappingURL=assistant.d.ts.map

package/dist/commands/assistant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assistant.d.ts","sourceRoot":"","sources":["../../src/commands/assistant.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAOlB,KAAK,iBAAiB,EAKtB,KAAK,cAAc,EAEnB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGvF;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAA;IAChC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;KAAE,CAAA;IAC1F,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CACjC;AAwFD,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0D/F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5C;AAyCD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,qBAAqB,GAC7B,YAAY,CAyCd"}
+{"version":3,"file":"assistant.d.ts","sourceRoot":"","sources":["../../src/commands/assistant.ts"],"names":[],"mappings":"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"}

package/dist/commands/assistant.js

@@ -1,42 +1,59 @@
-import { createAssistToolset, createHashingEmbeddingProvider, createImageProviderRegistry, createProviderRegistry, createSemanticSearch, createVectorRegistry, PROVIDER_NAMES, } from '@cogenta/agents';
-import { searchDocumentFor } from '@cogenta/schema';
-function isProviderName(value) {
-    return PROVIDER_NAMES.includes(value);
+import { createAssistToolset, createAssistUsageTracker, createHashingEmbeddingProvider, createImageProviderRegistry, createProviderRegistry, createReferenceDocumentStore, createSemanticSearch, createVectorRegistry, extractDocumentText, ingestReferenceDocument, MAX_DOCUMENT_BYTES, REFERENCE_DOCUMENT_COLLECTION, removeReferenceDocumentVectors, } from '@cogenta/agents';
+import { CogentaError } from '@cogenta/core';
+import { SITE_SETTINGS_SITE_SCOPE, searchDocumentFor } from '@cogenta/schema';
+/** The one site setting this task adds — a record of collection name → included, absent meaning included (opt-out, so an existing site's behaviour before this task does not change). */
+const INDEXED_COLLECTIONS_SETTING = 'assistant.indexedCollections';
+/**
+ * Reads the live toggle for one collection. Exported so `cogenta serve`'s
+ * "Reindex vectors" tool body (`tools.ts`) can honour the exact same
+ * predicate the write path uses, rather than a second copy of this read.
+ */
+export async function isAssistantCollectionEnabled(settings, collectionName) {
+    const row = await settings.get(INDEXED_COLLECTIONS_SETTING, SITE_SETTINGS_SITE_SCOPE);
+    const map = row?.value ?? {};
+    return map[collectionName] !== false;
 }
 /**
  * The text client, or nothing.
  *
- * A configured provider whose name this build does not know, or whose API key
- * is missing, produces `undefined` and a warning — never a throw. An operator
- * who mistyped a provider name should get a site that works with the assistant
- * off, plus a log line saying exactly that.
+ * Fiche 56 widened `provider` to a free string validated by
+ * `createProviderRegistry` itself (a catalog id, or any id paired with a
+ * `baseUrl` for a custom OpenAI-compatible endpoint) — so this no longer
+ * duplicates that check against a fixed 3-name list (the exact
+ * desynchronisation trap `CONTRACT_C_PERMISSIONS` already taught this
+ * codebase to avoid). A provider this build cannot resolve, or whose API key
+ * is missing, produces `undefined` and a warning — never a throw. An
+ * operator who mistyped a provider name should get a site that works with
+ * the assistant off, plus a log line saying exactly that.
  */
 function textProvider(options) {
     const llm = options.config.llm;
     if (llm === undefined)
         return undefined;
-    if (!isProviderName(llm.provider)) {
-        options.logger.warn('unknown LLM provider, the writing assistant stays off', {
+    if (llm.apiKey === undefined) {
+        options.logger.warn('LLM provider configured with no API key, the writing assistant stays off', {
             provider: llm.provider,
-            known: PROVIDER_NAMES,
+            variable: 'COGENTA_LLM_API_KEY',
         });
         return undefined;
     }
-    if (llm.apiKey === undefined) {
-        options.logger.warn('LLM provider configured with no API key, the writing assistant stays off', {
+    try {
+        const registry = createProviderRegistry({
+            [llm.provider]: {
+                apiKey: llm.apiKey,
+                model: llm.model,
+                ...(llm.baseUrl === undefined ? {} : { baseUrl: llm.baseUrl }),
+            },
+        });
+        return registry.get(llm.provider);
+    }
+    catch (error) {
+        options.logger.warn('LLM provider could not be resolved, the writing assistant stays off', {
             provider: llm.provider,
-            variable: 'COGENTA_LLM_API_KEY',
+            error: error instanceof Error ? error.message : String(error),
         });
         return undefined;
     }
-    const registry = createProviderRegistry({
-        [llm.provider]: {
-            apiKey: llm.apiKey,
-            model: llm.model,
-            ...(llm.baseUrl === undefined ? {} : { baseUrl: llm.baseUrl }),
-        },
-    });
-    return registry.get(llm.provider);
 }
 function imageProvider(options) {
     const images = options.config.imageGeneration;
@@ -108,20 +125,122 @@ export async function buildAssistant(options) {
             embeddings,
             ...(options.fullText === undefined ? {} : { fullText: options.fullText }),
         });
+    // Fiche 30 task 3. Only present when a text provider is present — a site
+    // with no AI provider has nothing to meter (R2), and `createAssistToolset`
+    // itself would drop a tracker handed to it anyway once `runtime` is
+    // `undefined`, so building one unconditionally would just be dead weight.
+    const usage = provider === undefined
+        ? undefined
+        : createAssistUsageTracker({
+            limits: { monthlyTokenLimit: config.assistant.monthlyTokenLimit },
+        });
     const toolset = createAssistToolset({
         site: { name: config.site.name, locales: config.site.locales },
         ...(provider === undefined ? {} : { provider }),
         ...(images === undefined ? {} : { imageProvider: images }),
         ...(search === undefined ? {} : { search }),
         ...(store === undefined || embeddings === undefined ? {} : { vectors: { store, embeddings } }),
+        ...(usage === undefined ? {} : { usage }),
+        ...(options.promptTemplates === undefined ? {} : { promptTemplates: options.promptTemplates }),
     });
     const summary = toolset.available
         ? `assistant: ${toolset.tools.length} tool(s), text provider: ${provider?.name ?? 'none'}, image provider: ${images?.name ?? 'none'}, vector driver: ${vectorDriver}`
         : 'assistant: off (no AI provider configured)';
+    const isEnabled = (collectionName) => isAssistantCollectionEnabled(options.settings, collectionName);
+    // Fiche 30 task 6, widened by L22 task 4. Only when there is a real store —
+    // `vectorDriver` stays `'none'` and `store` stays `undefined` on a site with
+    // no embedder, and an "index" with no store to count is not a real state to
+    // report.
+    let lastIndexedAt = null;
+    const vectorInfo = store === undefined || embeddings === undefined
+        ? undefined
+        : {
+            driver: vectorDriver,
+            dimensions: embeddings.dimensions,
+            count: () => store.count(),
+            lastIndexedAt: () => lastIndexedAt,
+            noteIndexed: () => {
+                lastIndexedAt = new Date().toISOString();
+            },
+            referenceCollection: REFERENCE_DOCUMENT_COLLECTION,
+            collections: async () => {
+                const rows = [];
+                for (const collection of options.collections) {
+                    const [enabled, count] = await Promise.all([
+                        isEnabled(collection.name),
+                        store.count({ siteId: options.siteId, collections: [collection.name] }),
+                    ]);
+                    rows.push({ name: collection.name, enabled, count });
+                }
+                return rows;
+            },
+        };
+    /**
+     * A nested function rather than an inline ternary: `store`/`embeddings`
+     * narrow to their non-optional type for the rest of *this* function body
+     * once checked here, which a value captured from the outer scope by a
+     * separately-declared closure does not reliably do.
+     */
+    async function buildDocumentService() {
+        if (store === undefined || embeddings === undefined)
+            return undefined;
+        const vectorStore = store;
+        const embeddingProviderRef = embeddings;
+        const docStore = createReferenceDocumentStore(options.db);
+        // Created eagerly, once — every method below (`list` included) reads or
+        // writes this table, so it must exist before the first request, not only
+        // before the first upload.
+        await docStore.ensureTable();
+        return {
+            list: () => docStore.list(options.siteId),
+            async upload({ filename, bytes, uploadedBy }) {
+                if (bytes.byteLength > MAX_DOCUMENT_BYTES) {
+                    throw new CogentaError({
+                        code: 'DOCUMENT_TOO_LARGE',
+                        message: `"${filename}" is larger than this route accepts.`,
+                        hint: 'Upload a document of 20 MB or less, or paste the section as plain text into a .txt/.md file.',
+                        details: { filename },
+                    });
+                }
+                const extracted = extractDocumentText({ filename, bytes });
+                const created = await docStore.create({
+                    siteId: options.siteId,
+                    filename: extracted.filename,
+                    format: extracted.format,
+                    characters: extracted.characters,
+                    warnings: extracted.warnings,
+                    uploadedBy,
+                });
+                try {
+                    const { chunkCount } = await ingestReferenceDocument({ filename: extracted.filename, text: extracted.text }, created.id, { store: vectorStore, embeddings: embeddingProviderRef, siteId: options.siteId });
+                    const at = new Date().toISOString();
+                    await docStore.markIndexed(options.siteId, created.id, chunkCount, at);
+                    lastIndexedAt = at;
+                    const reread = await docStore.get(options.siteId, created.id);
+                    return reread ?? created;
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    await docStore.markError(options.siteId, created.id, message);
+                    const reread = await docStore.get(options.siteId, created.id);
+                    return reread ?? created;
+                }
+            },
+            async remove(id) {
+                await removeReferenceDocumentVectors(vectorStore, options.siteId, id);
+                await docStore.remove(options.siteId, id);
+            },
+        };
+    }
+    const documents = await buildDocumentService();
     return {
         toolset,
         ...(search === undefined ? {} : { search }),
-        ...(store === undefined || embeddings === undefined ? {} : { vectors: { store, embeddings } }),
+        ...(store === undefined || embeddings === undefined
+            ? {}
+            : { vectors: { store, embeddings, isEnabled } }),
+        ...(vectorInfo === undefined ? {} : { vectorInfo }),
+        ...(documents === undefined ? {} : { documents }),
         summary,
         dispose: async () => {
             await disposeVectors?.();
@@ -162,24 +281,71 @@ async function recordFor(options, document) {
         vector,
     };
 }
-export function withVectorIndexing(store, options) {
-    async function reindex(id) {
-        try {
-            const published = await store.read(id, { state: 'published' });
-            if (published === null) {
-                await options.store.remove([chunkIdFor(options.collection.name, id)]);
-                return;
-            }
-            const record = await recordFor(options, searchDocumentFor(options.collection, published));
-            if (record === null) {
-                await options.store.remove([chunkIdFor(options.collection.name, id)]);
-                return;
-            }
-            await options.store.upsert([record]);
+/**
+ * Re-derives the indexed vector chunk(s) for one entry. Exported so a full
+ * rebuild (`reindexAllVectors`, and the "Reindex vectors" tool, fiche 24 task
+ * 3) reuses exactly what the write path does on every save, rather than a
+ * second copy of the published-only rule this indexer enforces.
+ */
+export async function reindexVectorEntry(store, options, id) {
+    try {
+        const enabled = options.isEnabled === undefined ? true : await options.isEnabled(options.collection.name);
+        if (!enabled) {
+            // Excluded by the toggle (L22 task 4) — treated exactly like "no
+            // published face": whatever chunk this entry had is removed, and
+            // nothing new is written until the collection is re-enabled.
+            await options.store.remove([chunkIdFor(options.collection.name, id)]);
+            options.onIndexed?.();
+            return;
         }
-        catch (error) {
-            options.onError?.(error);
+        const published = await store.read(id, { state: 'published' });
+        if (published === null) {
+            await options.store.remove([chunkIdFor(options.collection.name, id)]);
+            options.onIndexed?.();
+            return;
+        }
+        const record = await recordFor(options, searchDocumentFor(options.collection, published));
+        if (record === null) {
+            await options.store.remove([chunkIdFor(options.collection.name, id)]);
+            options.onIndexed?.();
+            return;
         }
+        await options.store.upsert([record]);
+        options.onIndexed?.();
+    }
+    catch (error) {
+        options.onError?.(error);
+    }
+}
+/**
+ * Walks every entry of a collection and re-derives its vector chunk. Unlike
+ * search's `reindexAll`, only the published face is ever indexed (see the
+ * doc comment on `recordFor`'s caller above) — a trashed-but-published entry
+ * is still indexed, since trash is orthogonal to `status` (ADR-0022).
+ */
+export async function reindexAllVectors(store, options, onProgress) {
+    let cursor;
+    let count = 0;
+    for (;;) {
+        const page = await store.list({
+            trashed: 'include',
+            limit: 100,
+            ...(cursor ? { cursor } : {}),
+        });
+        for (const entry of page.items) {
+            await reindexVectorEntry(store, options, entry.id);
+            count += 1;
+            onProgress?.(count);
+        }
+        if (!page.hasMore || page.nextCursor === null)
+            break;
+        cursor = page.nextCursor;
+    }
+    return count;
+}
+export function withVectorIndexing(store, options) {
+    async function reindex(id) {
+        await reindexVectorEntry(store, options, id);
     }
     async function after(entry) {
         await reindex(entry.id);
@@ -196,6 +362,7 @@ export function withVectorIndexing(store, options) {
             const removed = await store.delete(id);
             try {
                 await options.store.remove([chunkIdFor(options.collection.name, id)]);
+                options.onIndexed?.();
             }
             catch (error) {
                 options.onError?.(error);

package/dist/commands/assistant.js.map

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

package/dist/commands/audit-integrity-alert.d.ts

@@ -0,0 +1,23 @@
+import type { AuditIntegrityStatus } from '@cogenta/auth';
+import type { Logger } from '@cogenta/core';
+/**
+ * Fiche 21 task 3's outbound half. `security-alerts.ts` explains why its own
+ * trigger is a request rather than a timer (R1: no durable worker); this one
+ * is the accepted exception — `runServe`'s own `setInterval` already is the
+ * scheduled-publication tick's clock, and reusing it here rather than
+ * inventing a second polling mechanism is the same trade that tick already
+ * made.
+ *
+ * Sent **once per break**, not once per tick: the caller passes `newlyBroken`
+ * from `AuditIntegrityStore.check()`, which is `true` only the run that first
+ * finds the chain broken. A tick every day for a break nobody has fixed yet
+ * would otherwise flood the channel with the same fact.
+ */
+export interface AuditIntegrityAlertOptions {
+    /** `null` disables the outbound half entirely — the admin notice still fires. */
+    readonly send: ((event: string, data: Readonly<Record<string, unknown>>) => Promise<void>) | null;
+    readonly siteUrl: string;
+    readonly logger: Logger;
+}
+export declare function sendAuditIntegrityAlert(status: AuditIntegrityStatus, options: AuditIntegrityAlertOptions): Promise<void>;
+//# sourceMappingURL=audit-integrity-alert.d.ts.map

package/dist/commands/audit-integrity-alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-integrity-alert.d.ts","sourceRoot":"","sources":["../../src/commands/audit-integrity-alert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,0BAA0B;IACzC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAA;IACjG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/commands/audit-integrity-alert.js

@@ -0,0 +1,33 @@
+import { buildAlert } from '@cogenta/channels';
+export async function sendAuditIntegrityAlert(status, options) {
+    if (options.send === null)
+        return;
+    try {
+        const adminUrl = new URL('/admin/audit', options.siteUrl).toString();
+        const entryPart = status.brokenEntryId === null
+            ? 'The exact entry could not be identified.'
+            : `The first affected entry is ${status.brokenEntryId}.`;
+        const alert = buildAlert({
+            title: 'Audit log integrity check failed',
+            severity: 'critical',
+            context: `The scheduled integrity check found the audit log's hash chain broken. ${entryPart}`,
+            expectedAction: 'Investigate before doing anything else: every entry from this point on cannot be trusted. Preserve the affected rows (do not purge them) until the cause is understood.',
+            adminUrl,
+        });
+        await options.send('security.audit_integrity_broken', {
+            severity: alert.severity,
+            title: alert.title,
+            context: alert.context,
+            expectedAction: alert.expectedAction,
+            adminUrl: alert.adminUrl,
+            brokenEntryId: status.brokenEntryId,
+            brokenAt: status.brokenAt,
+        });
+    }
+    catch (error) {
+        // Same rule as every other audit/alert write in this file's neighbours:
+        // a notification failing must never fail the check it is reporting on.
+        options.logger.error('audit integrity alert failed', { error: String(error) });
+    }
+}
+//# sourceMappingURL=audit-integrity-alert.js.map

package/dist/commands/audit-integrity-alert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-integrity-alert.js","sourceRoot":"","sources":["../../src/commands/audit-integrity-alert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAuB9C,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAA4B,EAC5B,OAAmC;IAEnC,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;QAAE,OAAM;IAEjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAA;QACpE,MAAM,SAAS,GACb,MAAM,CAAC,aAAa,KAAK,IAAI;YAC3B,CAAC,CAAC,0CAA0C;YAC5C,CAAC,CAAC,+BAA+B,MAAM,CAAC,aAAa,GAAG,CAAA;QAC5D,MAAM,KAAK,GAAG,UAAU,CAAC;YACvB,KAAK,EAAE,kCAAkC;YACzC,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,0EAA0E,SAAS,EAAE;YAC9F,cAAc,EACZ,yKAAyK;YAC3K,QAAQ;SACT,CAAC,CAAA;QAEF,MAAM,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE;YACpD,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,wEAAwE;QACxE,uEAAuE;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAChF,CAAC;AACH,CAAC"}

package/dist/commands/backup.d.ts

@@ -0,0 +1,78 @@
+import { type DatabaseHandle, type Logger } from '@cogenta/core';
+import { createBackup } from '@cogenta/export';
+import type { Output, Writer } from '../output.js';
+export type BackupSubcommand = 'create' | 'list';
+export type RestoreSubcommand = 'preview' | 'apply';
+export interface BackupOptions {
+    readonly subcommand: string | undefined;
+    readonly cwd?: string;
+    readonly env?: Record<string, string | undefined>;
+    readonly logger?: Logger;
+    readonly out: Output;
+    readonly stderr: Writer;
+    /** Directory backups are written to — never under the site's storage root (the plan's own piège). Default `.cogenta/backups`. */
+    readonly dir?: string;
+    readonly passphrase?: string;
+}
+export interface RestoreOptions {
+    readonly subcommand: string | undefined;
+    readonly file: string | undefined;
+    readonly cwd?: string;
+    readonly env?: Record<string, string | undefined>;
+    readonly logger?: Logger;
+    readonly out: Output;
+    readonly stderr: Writer;
+    readonly passphrase?: string;
+}
+/** Exported for `update/` (L22 task 9) — the same default directory, never a second one to keep in sync. */
+export declare function defaultBackupDir(cwd: string): string;
+/**
+ * Opens this site's own database, the way every command in this file that
+ * touches it does. Exported for `update/` (L22 task 9): the update system's
+ * history view needs the same audit log every other admin action already
+ * writes to, which needs the same open connection — never a second way to
+ * resolve `cogenta.config.mjs` into a live `DatabaseHandle`.
+ */
+export declare function openSite(options: {
+    readonly cwd?: string;
+    readonly env?: Record<string, string | undefined>;
+}, logger: Logger): Promise<{
+    readonly db: DatabaseHandle;
+    readonly site: {
+        name: string;
+        url: string;
+    };
+    readonly dispose: () => Promise<void>;
+}>;
+export interface CreateSiteBackupOptions {
+    readonly cwd?: string;
+    readonly env?: Record<string, string | undefined>;
+    readonly logger?: Logger;
+    /** Directory backups are written to. Default `.cogenta/backups`, same as `cogenta backup create`. */
+    readonly dir?: string;
+    readonly passphrase?: string;
+    /**
+     * `backup-` by default (`cogenta backup create`'s own filename). The
+     * update system (`update/restore-point.ts`) passes `update-` so a restore
+     * point taken automatically before an update is visible as such in
+     * `cogenta backup list` / the admin's history view, without a second
+     * directory or a second manifest format.
+     */
+    readonly filenamePrefix?: string;
+}
+export interface CreateSiteBackupResult {
+    readonly path: string;
+    readonly manifest: Awaited<ReturnType<typeof createBackup>>['manifest'];
+}
+/**
+ * The actual work behind `cogenta backup create` — factored out so
+ * `update/restore-point.ts` calls exactly this, not a reimplementation, for
+ * "un point de restauration obligatoire avant toute mise à jour" (L22 task
+ * 9, point 2: "réutilise `backup create`/`restore apply`, déjà réels depuis
+ * L9 fiche 26"). `runBackup`'s `create` subcommand below is now this
+ * function plus CLI-shaped output, nothing else.
+ */
+export declare function createSiteBackup(options: CreateSiteBackupOptions): Promise<CreateSiteBackupResult>;
+export declare function runBackup(options: BackupOptions): Promise<number>;
+export declare function runRestore(options: RestoreOptions): Promise<number>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/commands/backup.d.ts.map

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