@uluops/ops-sdk 6.4.1 → 6.5.1

package/dist/types/log.d.ts

@@ -0,0 +1,410 @@
+/**
+ * `ulu log` — the project's second history (ulu log spec v0.1.13 §3.2 D2/D10/D12,
+ * §3.3 D3/D13/D14, §3.6 D6/D15/D16; checklist Phase 3).
+ *
+ * Three reads: `projects.getLog` (the stream — runs and decisions interleaved
+ * newest first, keyset-paged), `projects.getLogStat` (the rollup) and
+ * `orgs.getLogStat` (the same rollup org-wide plus a per-project table). The
+ * shapes here are the API's business objects (`ops-uluops-api`
+ * `src/business-objects/project-log.ts`) parsed strictly at the boundary — a
+ * field the server adds is dropped, a field it removes fails the parse.
+ *
+ * Three ledger facts every consumer must keep (spec §2): `reason` is optional
+ * and `null` means *no reason recorded*; `source` is `'agent'` or `null`, and
+ * `null` is *unattributed*, never *human*; a `regression` event is a row a RUN
+ * re-detected, while a `resolved → open` decision without a run is *reopened
+ * by decision* (D12) — the SDK types both and does not collapse them.
+ */
+import { z } from 'zod';
+/** Event kinds the stream can carry; `kind` filters to a subset. */
+export declare const LOG_EVENT_KINDS: readonly ["run", "decision", "regression"];
+export type LogEventKind = (typeof LOG_EVENT_KINDS)[number];
+/**
+ * Query for `projects.getLog`. Keys go to the wire AS NAMED (`workflowType`,
+ * `includeArchived`) — the API's schema is camelCase and would silently ignore a
+ * snake_cased key, so this query deliberately does not pass through the
+ * SDK's generic `toApiQuery` (which snake_cases).
+ */
+export interface ProjectLogQuery {
+    /** ISO 8601; `since <= until` or the API answers 400. */
+    since?: string;
+    until?: string;
+    /** 1–500, default 50. Outside the range is a 400 (the API does not clamp). */
+    limit?: number;
+    /** Opaque — pass back a `nextCursor` verbatim. Anything else is a 400. */
+    cursor?: string;
+    /** Subset of event kinds; default all three. */
+    kind?: LogEventKind[];
+    /** Filters `run` events only — a ledger row has no workflow. */
+    workflowType?: string;
+    /** Two-sided: runs by snapshot agent name, ledger rows by `issues.agent`. */
+    agent?: string;
+    /** Archived runs are excluded unless this is `true`. */
+    includeArchived?: boolean;
+}
+/** Window for either rollup (§3.3): two frames on two clocks; no window means all time. */
+export interface LogStatQuery {
+    since?: string;
+    until?: string;
+}
+export declare const LogRunEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"run">;
+    runNumber: z.ZodNumber;
+    at: z.ZodString;
+    workflowType: z.ZodString;
+    definitionType: z.ZodNullable<z.ZodString>;
+    definitionName: z.ZodNullable<z.ZodString>;
+    definitionVersion: z.ZodNullable<z.ZodString>;
+    averageScore: z.ZodNullable<z.ZodNumber>;
+    allGatesPassed: z.ZodNullable<z.ZodBoolean>;
+    counts: z.ZodNullable<z.ZodObject<{
+        new: z.ZodNumber;
+        recurring: z.ZodNumber;
+        regressions: z.ZodNumber;
+        observed: z.ZodNumber;
+    }, z.core.$strip>>;
+    agents: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type LogRunEvent = z.infer<typeof LogRunEventSchema>;
+export declare const LogDecisionEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"decision">;
+    issueId: z.ZodString;
+    fingerprint: z.ZodString;
+    title: z.ZodString;
+    from: z.ZodNullable<z.ZodString>;
+    to: z.ZodString;
+    reason: z.ZodNullable<z.ZodString>;
+    source: z.ZodNullable<z.ZodLiteral<"agent">>;
+    at: z.ZodString;
+    seq: z.ZodNumber;
+}, z.core.$strip>;
+export type LogDecisionEvent = z.infer<typeof LogDecisionEventSchema>;
+export declare const LogRegressionEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"regression">;
+    issueId: z.ZodString;
+    fingerprint: z.ZodString;
+    title: z.ZodString;
+    viaRunNumber: z.ZodNullable<z.ZodNumber>;
+    source: z.ZodNullable<z.ZodLiteral<"agent">>;
+    at: z.ZodString;
+    seq: z.ZodNumber;
+}, z.core.$strip>;
+export type LogRegressionEvent = z.infer<typeof LogRegressionEventSchema>;
+export declare const LogEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"run">;
+    runNumber: z.ZodNumber;
+    at: z.ZodString;
+    workflowType: z.ZodString;
+    definitionType: z.ZodNullable<z.ZodString>;
+    definitionName: z.ZodNullable<z.ZodString>;
+    definitionVersion: z.ZodNullable<z.ZodString>;
+    averageScore: z.ZodNullable<z.ZodNumber>;
+    allGatesPassed: z.ZodNullable<z.ZodBoolean>;
+    counts: z.ZodNullable<z.ZodObject<{
+        new: z.ZodNumber;
+        recurring: z.ZodNumber;
+        regressions: z.ZodNumber;
+        observed: z.ZodNumber;
+    }, z.core.$strip>>;
+    agents: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"decision">;
+    issueId: z.ZodString;
+    fingerprint: z.ZodString;
+    title: z.ZodString;
+    from: z.ZodNullable<z.ZodString>;
+    to: z.ZodString;
+    reason: z.ZodNullable<z.ZodString>;
+    source: z.ZodNullable<z.ZodLiteral<"agent">>;
+    at: z.ZodString;
+    seq: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"regression">;
+    issueId: z.ZodString;
+    fingerprint: z.ZodString;
+    title: z.ZodString;
+    viaRunNumber: z.ZodNullable<z.ZodNumber>;
+    source: z.ZodNullable<z.ZodLiteral<"agent">>;
+    at: z.ZodString;
+    seq: z.ZodNumber;
+}, z.core.$strip>], "type">;
+export type LogEvent = z.infer<typeof LogEventSchema>;
+/** One page of the stream. The envelope IS the page (no `data` wrapper outside `data[]`). */
+export declare const ProjectLogPageSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"run">;
+        runNumber: z.ZodNumber;
+        at: z.ZodString;
+        workflowType: z.ZodString;
+        definitionType: z.ZodNullable<z.ZodString>;
+        definitionName: z.ZodNullable<z.ZodString>;
+        definitionVersion: z.ZodNullable<z.ZodString>;
+        averageScore: z.ZodNullable<z.ZodNumber>;
+        allGatesPassed: z.ZodNullable<z.ZodBoolean>;
+        counts: z.ZodNullable<z.ZodObject<{
+            new: z.ZodNumber;
+            recurring: z.ZodNumber;
+            regressions: z.ZodNumber;
+            observed: z.ZodNumber;
+        }, z.core.$strip>>;
+        agents: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"decision">;
+        issueId: z.ZodString;
+        fingerprint: z.ZodString;
+        title: z.ZodString;
+        from: z.ZodNullable<z.ZodString>;
+        to: z.ZodString;
+        reason: z.ZodNullable<z.ZodString>;
+        source: z.ZodNullable<z.ZodLiteral<"agent">>;
+        at: z.ZodString;
+        seq: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"regression">;
+        issueId: z.ZodString;
+        fingerprint: z.ZodString;
+        title: z.ZodString;
+        viaRunNumber: z.ZodNullable<z.ZodNumber>;
+        source: z.ZodNullable<z.ZodLiteral<"agent">>;
+        at: z.ZodString;
+        seq: z.ZodNumber;
+    }, z.core.$strip>], "type">>;
+    count: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    nextCursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProjectLogPage = z.infer<typeof ProjectLogPageSchema>;
+/** D14: fixed over all seven statuses; `merged` normally 0; `open` counts transitions INTO open (reopens). */
+export declare const LogByStatusSchema: z.ZodObject<{
+    open: z.ZodNumber;
+    completed: z.ZodNumber;
+    deferred: z.ZodNumber;
+    wontfix: z.ZodNumber;
+    merged: z.ZodNumber;
+    'false-positive': z.ZodNumber;
+    observation: z.ZodNumber;
+}, z.core.$strip>;
+/** Fixed over the five non-open statuses. */
+export declare const LogWithReasonSchema: z.ZodObject<{
+    completed: z.ZodNumber;
+    deferred: z.ZodNumber;
+    wontfix: z.ZodNumber;
+    'false-positive': z.ZodNumber;
+    observation: z.ZodNumber;
+}, z.core.$strip>;
+export declare const LogStatBodySchema: z.ZodObject<{
+    window: z.ZodObject<{
+        since: z.ZodNullable<z.ZodString>;
+        until: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    examined: z.ZodObject<{
+        runs: z.ZodNumber;
+        first: z.ZodNullable<z.ZodString>;
+        last: z.ZodNullable<z.ZodString>;
+        byWorkflow: z.ZodArray<z.ZodObject<{
+            workflowType: z.ZodString;
+            runs: z.ZodNumber;
+        }, z.core.$strip>>;
+        definitions: z.ZodNumber;
+    }, z.core.$strip>;
+    found: z.ZodObject<{
+        issues: z.ZodNumber;
+    }, z.core.$strip>;
+    decided: z.ZodObject<{
+        completed: z.ZodNumber;
+        deferred: z.ZodNumber;
+        wontfix: z.ZodNumber;
+        'false-positive': z.ZodNumber;
+        observation: z.ZodNumber;
+        open: z.ZodNumber;
+        withReason: z.ZodObject<{
+            completed: z.ZodNumber;
+            deferred: z.ZodNumber;
+            wontfix: z.ZodNumber;
+            'false-positive': z.ZodNumber;
+            observation: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    cameBack: z.ZodObject<{
+        detected: z.ZodNumber;
+        detectedEvents: z.ZodNumber;
+        reopened: z.ZodNumber;
+        reopenedEvents: z.ZodNumber;
+        lastDetectedAtAllTime: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    activity: z.ZodObject<{
+        decisions: z.ZodNumber;
+        byStatus: z.ZodObject<{
+            open: z.ZodNumber;
+            completed: z.ZodNumber;
+            deferred: z.ZodNumber;
+            wontfix: z.ZodNumber;
+            merged: z.ZodNumber;
+            'false-positive': z.ZodNumber;
+            observation: z.ZodNumber;
+        }, z.core.$strip>;
+        restated: z.ZodNumber;
+        runsWithCorrelation: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type LogStatBody = z.infer<typeof LogStatBodySchema>;
+export declare const ProjectLogStatSchema: z.ZodObject<{
+    window: z.ZodObject<{
+        since: z.ZodNullable<z.ZodString>;
+        until: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    examined: z.ZodObject<{
+        runs: z.ZodNumber;
+        first: z.ZodNullable<z.ZodString>;
+        last: z.ZodNullable<z.ZodString>;
+        byWorkflow: z.ZodArray<z.ZodObject<{
+            workflowType: z.ZodString;
+            runs: z.ZodNumber;
+        }, z.core.$strip>>;
+        definitions: z.ZodNumber;
+    }, z.core.$strip>;
+    found: z.ZodObject<{
+        issues: z.ZodNumber;
+    }, z.core.$strip>;
+    decided: z.ZodObject<{
+        completed: z.ZodNumber;
+        deferred: z.ZodNumber;
+        wontfix: z.ZodNumber;
+        'false-positive': z.ZodNumber;
+        observation: z.ZodNumber;
+        open: z.ZodNumber;
+        withReason: z.ZodObject<{
+            completed: z.ZodNumber;
+            deferred: z.ZodNumber;
+            wontfix: z.ZodNumber;
+            'false-positive': z.ZodNumber;
+            observation: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    cameBack: z.ZodObject<{
+        detected: z.ZodNumber;
+        detectedEvents: z.ZodNumber;
+        reopened: z.ZodNumber;
+        reopenedEvents: z.ZodNumber;
+        lastDetectedAtAllTime: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    activity: z.ZodObject<{
+        decisions: z.ZodNumber;
+        byStatus: z.ZodObject<{
+            open: z.ZodNumber;
+            completed: z.ZodNumber;
+            deferred: z.ZodNumber;
+            wontfix: z.ZodNumber;
+            merged: z.ZodNumber;
+            'false-positive': z.ZodNumber;
+            observation: z.ZodNumber;
+        }, z.core.$strip>;
+        restated: z.ZodNumber;
+        runsWithCorrelation: z.ZodNumber;
+    }, z.core.$strip>;
+    projectId: z.ZodString;
+}, z.core.$strip>;
+export type ProjectLogStat = z.infer<typeof ProjectLogStatSchema>;
+/** One row of the org rollup's table (D15): each column is that project's own rollup measure. */
+export declare const OrgLogProjectSummarySchema: z.ZodObject<{
+    name: z.ZodString;
+    runs: z.ZodNumber;
+    issues: z.ZodNumber;
+    fixed: z.ZodNumber;
+    regressions: z.ZodNumber;
+    lastRunAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type OrgLogProjectSummary = z.infer<typeof OrgLogProjectSummarySchema>;
+export declare const OrgLogStatSchema: z.ZodObject<{
+    window: z.ZodObject<{
+        since: z.ZodNullable<z.ZodString>;
+        until: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    examined: z.ZodObject<{
+        runs: z.ZodNumber;
+        first: z.ZodNullable<z.ZodString>;
+        last: z.ZodNullable<z.ZodString>;
+        byWorkflow: z.ZodArray<z.ZodObject<{
+            workflowType: z.ZodString;
+            runs: z.ZodNumber;
+        }, z.core.$strip>>;
+        definitions: z.ZodNumber;
+    }, z.core.$strip>;
+    found: z.ZodObject<{
+        issues: z.ZodNumber;
+    }, z.core.$strip>;
+    decided: z.ZodObject<{
+        completed: z.ZodNumber;
+        deferred: z.ZodNumber;
+        wontfix: z.ZodNumber;
+        'false-positive': z.ZodNumber;
+        observation: z.ZodNumber;
+        open: z.ZodNumber;
+        withReason: z.ZodObject<{
+            completed: z.ZodNumber;
+            deferred: z.ZodNumber;
+            wontfix: z.ZodNumber;
+            'false-positive': z.ZodNumber;
+            observation: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    cameBack: z.ZodObject<{
+        detected: z.ZodNumber;
+        detectedEvents: z.ZodNumber;
+        reopened: z.ZodNumber;
+        reopenedEvents: z.ZodNumber;
+        lastDetectedAtAllTime: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    activity: z.ZodObject<{
+        decisions: z.ZodNumber;
+        byStatus: z.ZodObject<{
+            open: z.ZodNumber;
+            completed: z.ZodNumber;
+            deferred: z.ZodNumber;
+            wontfix: z.ZodNumber;
+            merged: z.ZodNumber;
+            'false-positive': z.ZodNumber;
+            observation: z.ZodNumber;
+        }, z.core.$strip>;
+        restated: z.ZodNumber;
+        runsWithCorrelation: z.ZodNumber;
+    }, z.core.$strip>;
+    org: z.ZodString;
+    computedAt: z.ZodString;
+    projects: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        runs: z.ZodNumber;
+        issues: z.ZodNumber;
+        fixed: z.ZodNumber;
+        regressions: z.ZodNumber;
+        lastRunAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    hasMoreProjects: z.ZodBoolean;
+}, z.core.$strip>;
+export type OrgLogStat = z.infer<typeof OrgLogStatSchema>;
+export declare const OrgListEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    isPersonal: z.ZodBoolean;
+    role: z.ZodString;
+    memberCount: z.ZodNumber;
+    subscriptionTier: z.ZodString;
+    paymentStatus: z.ZodNullable<z.ZodString>;
+    suspendedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type OrgListEntry = z.infer<typeof OrgListEntrySchema>;
+export declare const OrgListResponseSchema: z.ZodObject<{
+    organizations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodString;
+        isPersonal: z.ZodBoolean;
+        role: z.ZodString;
+        memberCount: z.ZodNumber;
+        subscriptionTier: z.ZodString;
+        paymentStatus: z.ZodNullable<z.ZodString>;
+        suspendedAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+//# sourceMappingURL=log.d.ts.map

package/dist/types/log.d.ts.map

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

package/dist/types/log.js

@@ -0,0 +1,191 @@
+/**
+ * `ulu log` — the project's second history (ulu log spec v0.1.13 §3.2 D2/D10/D12,
+ * §3.3 D3/D13/D14, §3.6 D6/D15/D16; checklist Phase 3).
+ *
+ * Three reads: `projects.getLog` (the stream — runs and decisions interleaved
+ * newest first, keyset-paged), `projects.getLogStat` (the rollup) and
+ * `orgs.getLogStat` (the same rollup org-wide plus a per-project table). The
+ * shapes here are the API's business objects (`ops-uluops-api`
+ * `src/business-objects/project-log.ts`) parsed strictly at the boundary — a
+ * field the server adds is dropped, a field it removes fails the parse.
+ *
+ * Three ledger facts every consumer must keep (spec §2): `reason` is optional
+ * and `null` means *no reason recorded*; `source` is `'agent'` or `null`, and
+ * `null` is *unattributed*, never *human*; a `regression` event is a row a RUN
+ * re-detected, while a `resolved → open` decision without a run is *reopened
+ * by decision* (D12) — the SDK types both and does not collapse them.
+ */
+import { z } from 'zod';
+// ============================================
+// QUERIES
+// ============================================
+/** Event kinds the stream can carry; `kind` filters to a subset. */
+export const LOG_EVENT_KINDS = ['run', 'decision', 'regression'];
+// ============================================
+// STREAM (§3.2)
+// ============================================
+const nullableString = z.string().nullable();
+export const LogRunEventSchema = z.object({
+    type: z.literal('run'),
+    runNumber: z.number().int(),
+    /** As reported by the saving client — `pipeline_runs.timestamp` (1 s precision). */
+    at: z.string(),
+    workflowType: z.string(),
+    definitionType: nullableString,
+    definitionName: nullableString,
+    definitionVersion: nullableString,
+    averageScore: z.number().nullable(),
+    allGatesPassed: z.boolean().nullable(),
+    /** `null` on runs saved before migration 065 — stays `null`, never zeros. */
+    counts: z.object({
+        new: z.number().int(),
+        recurring: z.number().int(),
+        regressions: z.number().int(),
+        observed: z.number().int(),
+    }).nullable(),
+    agents: z.array(z.string()),
+});
+export const LogDecisionEventSchema = z.object({
+    type: z.literal('decision'),
+    issueId: z.string(),
+    /** 12-char prefix — what the `issues history` picker prints. */
+    fingerprint: z.string(),
+    title: z.string(),
+    from: nullableString,
+    to: z.string(),
+    /** `null` = no reason recorded. */
+    reason: nullableString,
+    /** `'agent'` or `null`; `null` is unattributed, never "human". */
+    source: z.literal('agent').nullable(),
+    /** Server clock — `status_history.changed_at` (ms precision). */
+    at: z.string(),
+    /** Insertion order within a second for post-080 rows; frozen-arbitrary before. Never chronology. */
+    seq: z.number().int(),
+});
+export const LogRegressionEventSchema = z.object({
+    type: z.literal('regression'),
+    issueId: z.string(),
+    fingerprint: z.string(),
+    title: z.string(),
+    /** `null` when the detecting run is archived or otherwise unresolvable — render *via run ?*. */
+    viaRunNumber: z.number().int().nullable(),
+    source: z.literal('agent').nullable(),
+    at: z.string(),
+    seq: z.number().int(),
+});
+export const LogEventSchema = z.discriminatedUnion('type', [LogRunEventSchema, LogDecisionEventSchema, LogRegressionEventSchema]);
+/** One page of the stream. The envelope IS the page (no `data` wrapper outside `data[]`). */
+export const ProjectLogPageSchema = z.object({
+    data: z.array(LogEventSchema),
+    count: z.number().int().nonnegative(),
+    hasMore: z.boolean(),
+    nextCursor: z.string().optional(),
+});
+// ============================================
+// ROLLUP (§3.3) — shared body, project and org heads
+// ============================================
+const nullableIso = z.string().nullable();
+/** D14: fixed over all seven statuses; `merged` normally 0; `open` counts transitions INTO open (reopens). */
+export const LogByStatusSchema = z.object({
+    open: z.number().int(),
+    completed: z.number().int(),
+    deferred: z.number().int(),
+    wontfix: z.number().int(),
+    merged: z.number().int(),
+    'false-positive': z.number().int(),
+    observation: z.number().int(),
+});
+/** Fixed over the five non-open statuses. */
+export const LogWithReasonSchema = z.object({
+    completed: z.number().int(),
+    deferred: z.number().int(),
+    wontfix: z.number().int(),
+    'false-positive': z.number().int(),
+    observation: z.number().int(),
+});
+export const LogStatBodySchema = z.object({
+    window: z.object({ since: nullableIso, until: nullableIso }),
+    /** Cohort frame — run clock. */
+    examined: z.object({
+        runs: z.number().int(),
+        first: nullableIso,
+        last: nullableIso,
+        byWorkflow: z.array(z.object({ workflowType: z.string(), runs: z.number().int() })),
+        /** Distinct definitions; (name, version) fallback for NULL ids. Not additive across projects. */
+        definitions: z.number().int(),
+    }),
+    found: z.object({ issues: z.number().int() }),
+    /** CURRENT status of each found issue — sums to `found.issues`; not "decisions in the window". */
+    decided: z.object({
+        completed: z.number().int(),
+        deferred: z.number().int(),
+        wontfix: z.number().int(),
+        'false-positive': z.number().int(),
+        observation: z.number().int(),
+        open: z.number().int(),
+        withReason: LogWithReasonSchema,
+    }),
+    /** D12: distinct issues, with the row count beside each. */
+    cameBack: z.object({
+        /** A run re-detected it (`run_id IS NOT NULL`). */
+        detected: z.number().int(),
+        detectedEvents: z.number().int(),
+        /** Reopened by decision (no run). Never "by hand". */
+        reopened: z.number().int(),
+        reopenedEvents: z.number().int(),
+        /** ANY window, by definition. */
+        lastDetectedAtAllTime: nullableIso,
+    }),
+    /** Activity frame — ledger clock. */
+    activity: z.object({
+        decisions: z.number().int(),
+        byStatus: LogByStatusSchema,
+        /** D13: re-stated dispositions (self-transitions) — counted, never listed. */
+        restated: z.number().int(),
+        /** Runs in the window with correlation counts recorded (saved after migration 065). */
+        runsWithCorrelation: z.number().int(),
+    }),
+});
+export const ProjectLogStatSchema = LogStatBodySchema.extend({ projectId: z.string() });
+/** One row of the org rollup's table (D15): each column is that project's own rollup measure. */
+export const OrgLogProjectSummarySchema = z.object({
+    name: z.string(),
+    /** = `examined.runs` */
+    runs: z.number().int(),
+    /** = `found.issues` */
+    issues: z.number().int(),
+    /** = `decided.completed` */
+    fixed: z.number().int(),
+    /** = `cameBack.detected` — run-caught only, not reopens by decision. */
+    regressions: z.number().int(),
+    /** The sort key (last run in the window, desc); `null` sorts last, by name. */
+    lastRunAt: nullableIso,
+});
+export const OrgLogStatSchema = LogStatBodySchema.extend({
+    /** The org slug the call named. */
+    org: z.string(),
+    /**
+     * When these numbers were computed. The org rollup is served from a 60 s TTL
+     * cache per (org, window) (D16) — a response can be that old, and this says how old.
+     */
+    computedAt: z.string(),
+    /** Live projects of the org, last run desc then name; at most 100 — `hasMoreProjects` says when the cap bit. */
+    projects: z.array(OrgLogProjectSummarySchema),
+    hasMoreProjects: z.boolean(),
+});
+// ============================================
+// ORG LIST (`GET /orgs`) — what `ulu log --orgs` iterates
+// ============================================
+export const OrgListEntrySchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    slug: z.string(),
+    isPersonal: z.boolean(),
+    role: z.string(),
+    memberCount: z.number().int().nonnegative(),
+    subscriptionTier: z.string(),
+    paymentStatus: z.string().nullable(),
+    suspendedAt: z.string().nullable(),
+});
+export const OrgListResponseSchema = z.object({ organizations: z.array(OrgListEntrySchema) });
+//# sourceMappingURL=log.js.map

package/dist/types/log.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uluops/ops-sdk",
-  "version": "6.4.1",
+  "version": "6.5.1",
   "description": "Track execution runs, manage issues, and query analytics against the UluOps platform API — typed TypeScript client with Zod runtime validation.",
   "type": "module",
   "main": "dist/index.js",
@@ -86,6 +86,11 @@
     "type": "git",
     "url": "git+https://github.com/Uluops/-uluops-ops-sdk.git"
   },
+  "homepage": "https://github.com/Uluops/-uluops-ops-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/Uluops/-uluops-ops-sdk/issues"
+  },
+  "sideEffects": false,
   "dependencies": {
     "@uluops/sdk-core": "0.17.0",
     "zod": "4.3.6"