windows-development-sandbox 1.11.7 → 1.13.0

package/dist/app/features/audit/audit.def.d.ts

@@ -0,0 +1,350 @@
+import { z } from 'zod';
+import { type Page } from '../../kernel/index.js';
+export declare const AUDIT_EVENT_KINDS: readonly ["proc", "file", "commit", "session", "guard", "note", "remote"];
+export declare const AUDIT_KIND_FILTERS: readonly ["all", "proc", "file", "commit", "session", "guard", "remote"];
+/** The session filter that means "not linked to any session". */
+export declare const NO_SESSION = "none";
+export declare const AuditRowSchema: z.ZodObject<{
+    time: z.ZodString;
+    kind: z.ZodEnum<{
+        file: "file";
+        remote: "remote";
+        session: "session";
+        note: "note";
+        commit: "commit";
+        proc: "proc";
+        guard: "guard";
+    }>;
+    what: z.ZodString;
+    command: z.ZodOptional<z.ZodString>;
+    parent: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodString>;
+    folder: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+    session: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    linked: z.ZodOptional<z.ZodEnum<{
+        process: "process";
+        "only-session": "only-session";
+    }>>;
+    count: z.ZodNumber;
+    sha: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AuditRow = z.output<typeof AuditRowSchema>;
+export declare const AuditSessionSchema: z.ZodObject<{
+    commands: z.ZodNumber;
+    files: z.ZodNumber;
+    commits: z.ZodNumber;
+    id: z.ZodString;
+    agent: z.ZodString;
+    project: z.ZodString;
+    started: z.ZodString;
+    ended: z.ZodOptional<z.ZodString>;
+    last: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AuditSession = z.output<typeof AuditSessionSchema>;
+export declare const AuditAgentSchema: z.ZodObject<{
+    commands: z.ZodNumber;
+    files: z.ZodNumber;
+    commits: z.ZodNumber;
+    agent: z.ZodString;
+    sessions: z.ZodNumber;
+}, z.core.$strip>;
+export declare const AuditListSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    keepDays: z.ZodNumber;
+    maxMb: z.ZodNumber;
+    bytes: z.ZodNumber;
+    folder: z.ZodString;
+    filter: z.ZodObject<{
+        days: z.ZodNumber;
+        kind: z.ZodEnum<{
+            file: "file";
+            remote: "remote";
+            all: "all";
+            session: "session";
+            commit: "commit";
+            proc: "proc";
+            guard: "guard";
+        }>;
+        session: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        project: z.ZodOptional<z.ZodString>;
+        grep: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    matched: z.ZodNumber;
+    events: z.ZodArray<z.ZodObject<{
+        time: z.ZodString;
+        kind: z.ZodEnum<{
+            file: "file";
+            remote: "remote";
+            session: "session";
+            note: "note";
+            commit: "commit";
+            proc: "proc";
+            guard: "guard";
+        }>;
+        what: z.ZodString;
+        command: z.ZodOptional<z.ZodString>;
+        parent: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodString>;
+        folder: z.ZodOptional<z.ZodString>;
+        project: z.ZodOptional<z.ZodString>;
+        session: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        linked: z.ZodOptional<z.ZodEnum<{
+            process: "process";
+            "only-session": "only-session";
+        }>>;
+        count: z.ZodNumber;
+        sha: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totals: z.ZodObject<{
+        commands: z.ZodNumber;
+        files: z.ZodNumber;
+        commits: z.ZodNumber;
+        events: z.ZodNumber;
+        sessions: z.ZodNumber;
+    }, z.core.$strip>;
+    agents: z.ZodArray<z.ZodObject<{
+        commands: z.ZodNumber;
+        files: z.ZodNumber;
+        commits: z.ZodNumber;
+        agent: z.ZodString;
+        sessions: z.ZodNumber;
+    }, z.core.$strip>>;
+    sessions: z.ZodArray<z.ZodObject<{
+        commands: z.ZodNumber;
+        files: z.ZodNumber;
+        commits: z.ZodNumber;
+        id: z.ZodString;
+        agent: z.ZodString;
+        project: z.ZodString;
+        started: z.ZodString;
+        ended: z.ZodOptional<z.ZodString>;
+        last: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    unlinked: z.ZodObject<{
+        commands: z.ZodNumber;
+        files: z.ZodNumber;
+        commits: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AuditList = z.output<typeof AuditListSchema>;
+export declare const listAudit: import("../../kernel/define.js").QueryDef<z.ZodObject<{
+    days: z.ZodDefault<z.ZodNumber>;
+    kind: z.ZodDefault<z.ZodEnum<{
+        file: "file";
+        remote: "remote";
+        all: "all";
+        session: "session";
+        commit: "commit";
+        proc: "proc";
+        guard: "guard";
+    }>>;
+    session: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+    grep: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    enabled: z.ZodBoolean;
+    keepDays: z.ZodNumber;
+    maxMb: z.ZodNumber;
+    bytes: z.ZodNumber;
+    folder: z.ZodString;
+    filter: z.ZodObject<{
+        days: z.ZodNumber;
+        kind: z.ZodEnum<{
+            file: "file";
+            remote: "remote";
+            all: "all";
+            session: "session";
+            commit: "commit";
+            proc: "proc";
+            guard: "guard";
+        }>;
+        session: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        project: z.ZodOptional<z.ZodString>;
+        grep: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    matched: z.ZodNumber;
+    events: z.ZodArray<z.ZodObject<{
+        time: z.ZodString;
+        kind: z.ZodEnum<{
+            file: "file";
+            remote: "remote";
+            session: "session";
+            note: "note";
+            commit: "commit";
+            proc: "proc";
+            guard: "guard";
+        }>;
+        what: z.ZodString;
+        command: z.ZodOptional<z.ZodString>;
+        parent: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodString>;
+        folder: z.ZodOptional<z.ZodString>;
+        project: z.ZodOptional<z.ZodString>;
+        session: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        linked: z.ZodOptional<z.ZodEnum<{
+            process: "process";
+            "only-session": "only-session";
+        }>>;
+        count: z.ZodNumber;
+        sha: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    totals: z.ZodObject<{
+        commands: z.ZodNumber;
+        files: z.ZodNumber;
+        commits: z.ZodNumber;
+        events: z.ZodNumber;
+        sessions: z.ZodNumber;
+    }, z.core.$strip>;
+    agents: z.ZodArray<z.ZodObject<{
+        commands: z.ZodNumber;
+        files: z.ZodNumber;
+        commits: z.ZodNumber;
+        agent: z.ZodString;
+        sessions: z.ZodNumber;
+    }, z.core.$strip>>;
+    sessions: z.ZodArray<z.ZodObject<{
+        commands: z.ZodNumber;
+        files: z.ZodNumber;
+        commits: z.ZodNumber;
+        id: z.ZodString;
+        agent: z.ZodString;
+        project: z.ZodString;
+        started: z.ZodString;
+        ended: z.ZodOptional<z.ZodString>;
+        last: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    unlinked: z.ZodObject<{
+        commands: z.ZodNumber;
+        files: z.ZodNumber;
+        commits: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, "audit.list">;
+/** "14:03:22" today, "Oct 18 14:03" before (local time). */
+export declare function eventTime(iso: string, now?: number): string;
+/** The first few characters of a session id (enough to tell sessions apart, and to filter by). */
+export declare function shortId(id: string): string;
+/** What an event says, in one line. */
+export declare function eventWhat(e: AuditRow): string;
+/** The page: the period's totals, per agent, the sessions (each opens its own events), and the events. Pure. */
+export declare function auditPage(o: AuditList): Page;
+/** The command line that shows what a view address of this page shows (the menu runs it on the normal screen). */
+export declare function auditArgv(params?: Readonly<Record<string, string>>): string[];
+/** What the view's address can set. */
+export interface AuditParams {
+    readonly days?: string;
+    readonly kind?: string;
+    readonly session?: string;
+    readonly agent?: string;
+    readonly project?: string;
+    readonly grep?: string;
+}
+export declare const auditView: import("../../kernel/define.js").ViewDef<{
+    audit: import("../../kernel/define.js").QueryDef<z.ZodObject<{
+        days: z.ZodDefault<z.ZodNumber>;
+        kind: z.ZodDefault<z.ZodEnum<{
+            file: "file";
+            remote: "remote";
+            all: "all";
+            session: "session";
+            commit: "commit";
+            proc: "proc";
+            guard: "guard";
+        }>>;
+        session: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        project: z.ZodOptional<z.ZodString>;
+        grep: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        enabled: z.ZodBoolean;
+        keepDays: z.ZodNumber;
+        maxMb: z.ZodNumber;
+        bytes: z.ZodNumber;
+        folder: z.ZodString;
+        filter: z.ZodObject<{
+            days: z.ZodNumber;
+            kind: z.ZodEnum<{
+                file: "file";
+                remote: "remote";
+                all: "all";
+                session: "session";
+                commit: "commit";
+                proc: "proc";
+                guard: "guard";
+            }>;
+            session: z.ZodOptional<z.ZodString>;
+            agent: z.ZodOptional<z.ZodString>;
+            project: z.ZodOptional<z.ZodString>;
+            grep: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        matched: z.ZodNumber;
+        events: z.ZodArray<z.ZodObject<{
+            time: z.ZodString;
+            kind: z.ZodEnum<{
+                file: "file";
+                remote: "remote";
+                session: "session";
+                note: "note";
+                commit: "commit";
+                proc: "proc";
+                guard: "guard";
+            }>;
+            what: z.ZodString;
+            command: z.ZodOptional<z.ZodString>;
+            parent: z.ZodOptional<z.ZodString>;
+            action: z.ZodOptional<z.ZodString>;
+            folder: z.ZodOptional<z.ZodString>;
+            project: z.ZodOptional<z.ZodString>;
+            session: z.ZodOptional<z.ZodString>;
+            agent: z.ZodOptional<z.ZodString>;
+            linked: z.ZodOptional<z.ZodEnum<{
+                process: "process";
+                "only-session": "only-session";
+            }>>;
+            count: z.ZodNumber;
+            sha: z.ZodOptional<z.ZodString>;
+            author: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        totals: z.ZodObject<{
+            commands: z.ZodNumber;
+            files: z.ZodNumber;
+            commits: z.ZodNumber;
+            events: z.ZodNumber;
+            sessions: z.ZodNumber;
+        }, z.core.$strip>;
+        agents: z.ZodArray<z.ZodObject<{
+            commands: z.ZodNumber;
+            files: z.ZodNumber;
+            commits: z.ZodNumber;
+            agent: z.ZodString;
+            sessions: z.ZodNumber;
+        }, z.core.$strip>>;
+        sessions: z.ZodArray<z.ZodObject<{
+            commands: z.ZodNumber;
+            files: z.ZodNumber;
+            commits: z.ZodNumber;
+            id: z.ZodString;
+            agent: z.ZodString;
+            project: z.ZodString;
+            started: z.ZodString;
+            ended: z.ZodOptional<z.ZodString>;
+            last: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        unlinked: z.ZodObject<{
+            commands: z.ZodNumber;
+            files: z.ZodNumber;
+            commits: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>, "audit.list">;
+}, AuditParams, "audit">;