@claudexor/schema 1.0.1 → 2.1.1

package/dist/control-gc.d.ts

@@ -0,0 +1,185 @@
+import { z } from "zod";
+/**
+ * Disk-retention (GC) control operation (W3.6). The daemon owns the
+ * retention service; this is its schema-first contract: a typed request
+ * (dry-run first-class) and a typed receipt that discloses exactly what was
+ * deleted and WHY every survivor survived — silent deletion or silent
+ * retention are both bugs.
+ */
+/** Why a candidate run tree survived this GC pass. */
+export declare const GcKeepReason: z.ZodEnum<["active", "recent", "young", "referenced", "actionable", "unknown_state"]>;
+export type GcKeepReason = z.infer<typeof GcKeepReason>;
+export declare const ControlGcRequest: z.ZodObject<{
+    dry_run: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    dry_run: boolean;
+}, {
+    dry_run?: boolean | undefined;
+}>;
+export type ControlGcRequest = z.infer<typeof ControlGcRequest>;
+export declare const GcRunDeletion: z.ZodObject<{
+    run_id: z.ZodString;
+    project_root: z.ZodString;
+    freed_bytes: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    run_id: string;
+    project_root: string;
+    freed_bytes: number;
+}, {
+    run_id: string;
+    project_root: string;
+    freed_bytes: number;
+}>;
+export type GcRunDeletion = z.infer<typeof GcRunDeletion>;
+export declare const GcKeepCounts: z.ZodObject<{
+    active: z.ZodDefault<z.ZodNumber>;
+    recent: z.ZodDefault<z.ZodNumber>;
+    young: z.ZodDefault<z.ZodNumber>;
+    referenced: z.ZodDefault<z.ZodNumber>;
+    actionable: z.ZodDefault<z.ZodNumber>;
+    unknown_state: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    active: number;
+    recent: number;
+    young: number;
+    referenced: number;
+    actionable: number;
+    unknown_state: number;
+}, {
+    active?: number | undefined;
+    recent?: number | undefined;
+    young?: number | undefined;
+    referenced?: number | undefined;
+    actionable?: number | undefined;
+    unknown_state?: number | undefined;
+}>;
+export type GcKeepCounts = z.infer<typeof GcKeepCounts>;
+export declare const ControlGcReceipt: z.ZodObject<{
+    schema_version: z.ZodDefault<z.ZodLiteral<1>>;
+    dry_run: z.ZodBoolean;
+    started_at: z.ZodString;
+    finished_at: z.ZodString;
+    policy: z.ZodObject<{
+        runs_max_age_days: z.ZodNumber;
+        reviews_max_age_days: z.ZodNumber;
+        keep_last_runs_per_project: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        runs_max_age_days: number;
+        reviews_max_age_days: number;
+        keep_last_runs_per_project: number;
+    }, {
+        runs_max_age_days: number;
+        reviews_max_age_days: number;
+        keep_last_runs_per_project: number;
+    }>;
+    examined_runs: z.ZodNumber;
+    deleted_runs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        run_id: z.ZodString;
+        project_root: z.ZodString;
+        freed_bytes: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        run_id: string;
+        project_root: string;
+        freed_bytes: number;
+    }, {
+        run_id: string;
+        project_root: string;
+        freed_bytes: number;
+    }>, "many">>;
+    kept: z.ZodObject<{
+        active: z.ZodDefault<z.ZodNumber>;
+        recent: z.ZodDefault<z.ZodNumber>;
+        young: z.ZodDefault<z.ZodNumber>;
+        referenced: z.ZodDefault<z.ZodNumber>;
+        actionable: z.ZodDefault<z.ZodNumber>;
+        unknown_state: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        active: number;
+        recent: number;
+        young: number;
+        referenced: number;
+        actionable: number;
+        unknown_state: number;
+    }, {
+        active?: number | undefined;
+        recent?: number | undefined;
+        young?: number | undefined;
+        referenced?: number | undefined;
+        actionable?: number | undefined;
+        unknown_state?: number | undefined;
+    }>;
+    deleted_reviews: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        freed_bytes: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        freed_bytes: number;
+    }, {
+        path: string;
+        freed_bytes: number;
+    }>, "many">>;
+    freed_bytes: z.ZodNumber;
+    errors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    schema_version: 1;
+    policy: {
+        runs_max_age_days: number;
+        reviews_max_age_days: number;
+        keep_last_runs_per_project: number;
+    };
+    dry_run: boolean;
+    freed_bytes: number;
+    started_at: string;
+    finished_at: string;
+    examined_runs: number;
+    deleted_runs: {
+        run_id: string;
+        project_root: string;
+        freed_bytes: number;
+    }[];
+    kept: {
+        active: number;
+        recent: number;
+        young: number;
+        referenced: number;
+        actionable: number;
+        unknown_state: number;
+    };
+    deleted_reviews: {
+        path: string;
+        freed_bytes: number;
+    }[];
+    errors: string[];
+}, {
+    policy: {
+        runs_max_age_days: number;
+        reviews_max_age_days: number;
+        keep_last_runs_per_project: number;
+    };
+    dry_run: boolean;
+    freed_bytes: number;
+    started_at: string;
+    finished_at: string;
+    examined_runs: number;
+    kept: {
+        active?: number | undefined;
+        recent?: number | undefined;
+        young?: number | undefined;
+        referenced?: number | undefined;
+        actionable?: number | undefined;
+        unknown_state?: number | undefined;
+    };
+    schema_version?: 1 | undefined;
+    deleted_runs?: {
+        run_id: string;
+        project_root: string;
+        freed_bytes: number;
+    }[] | undefined;
+    deleted_reviews?: {
+        path: string;
+        freed_bytes: number;
+    }[] | undefined;
+    errors?: string[] | undefined;
+}>;
+export type ControlGcReceipt = z.infer<typeof ControlGcReceipt>;
+//# sourceMappingURL=control-gc.d.ts.map

package/dist/control-gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-gc.d.ts","sourceRoot":"","sources":["../src/control-gc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AAEH,sDAAsD;AACtD,eAAO,MAAM,YAAY,uFAItB,CAAC;AACJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;EAQ6C,CAAC;AAC3E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,aAAa;;;;;;;;;;;;EAMf,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;EAUsB,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0CsB,CAAC;AACpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/control-gc.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+/**
+ * Disk-retention (GC) control operation (W3.6). The daemon owns the
+ * retention service; this is its schema-first contract: a typed request
+ * (dry-run first-class) and a typed receipt that discloses exactly what was
+ * deleted and WHY every survivor survived — silent deletion or silent
+ * retention are both bugs.
+ */
+/** Why a candidate run tree survived this GC pass. */
+export const GcKeepReason = z
+    .enum(["active", "recent", "young", "referenced", "actionable", "unknown_state"])
+    .describe("Why a run tree survived: active (nonterminal daemon record), recent (newest-N per project), young (inside the age window), referenced (a live thread points at it), actionable (undelivered/applyable/blocked work awaiting the operator), unknown_state (no terminal evidence — fail closed).");
+export const ControlGcRequest = z
+    .object({
+    dry_run: z
+        .boolean()
+        .default(false)
+        .describe("Report what WOULD be deleted without touching disk."),
+})
+    .strict()
+    .describe("Run one retention pass over engine-owned runtime artifacts.");
+export const GcRunDeletion = z
+    .object({
+    run_id: z.string().describe("Deleted (or would-be-deleted) run id."),
+    project_root: z.string().describe("Canonical project root owning the run tree."),
+    freed_bytes: z.number().int().nonnegative().describe("Bytes the tree occupied."),
+})
+    .strict();
+export const GcKeepCounts = z
+    .object({
+    active: z.number().int().nonnegative().default(0),
+    recent: z.number().int().nonnegative().default(0),
+    young: z.number().int().nonnegative().default(0),
+    referenced: z.number().int().nonnegative().default(0),
+    actionable: z.number().int().nonnegative().default(0),
+    unknown_state: z.number().int().nonnegative().default(0),
+})
+    .strict()
+    .describe("Survivor counts per keep reason.");
+export const ControlGcReceipt = z
+    .object({
+    schema_version: z.literal(1).default(1),
+    dry_run: z.boolean().describe("Whether disk was left untouched."),
+    started_at: z.string().describe("Pass start (ISO 8601)."),
+    finished_at: z.string().describe("Pass end (ISO 8601)."),
+    policy: z
+        .object({
+        runs_max_age_days: z.number().int().positive(),
+        reviews_max_age_days: z.number().int().positive(),
+        keep_last_runs_per_project: z.number().int().nonnegative(),
+    })
+        .strict()
+        .describe("The effective retention policy this pass applied."),
+    examined_runs: z.number().int().nonnegative().describe("Run trees examined."),
+    deleted_runs: z
+        .array(GcRunDeletion)
+        .default([])
+        .describe("Run trees deleted (or would-be under dry_run), tombstones left behind."),
+    kept: GcKeepCounts.describe("Why every surviving candidate survived."),
+    deleted_reviews: z
+        .array(z
+        .object({
+        path: z.string().describe("Deleted standalone diff-review tree."),
+        freed_bytes: z.number().int().nonnegative(),
+    })
+        .strict())
+        .default([])
+        .describe("Standalone diff-review trees deleted (or would-be under dry_run)."),
+    freed_bytes: z
+        .number()
+        .int()
+        .nonnegative()
+        .describe("Total bytes freed (or reclaimable under dry_run)."),
+    errors: z
+        .array(z.string())
+        .default([])
+        .describe("Non-fatal per-tree failures; the pass continues past them."),
+})
+    .strict()
+    .describe("Typed receipt of one retention pass.");
+//# sourceMappingURL=control-gc.js.map

package/dist/control-gc.js.map

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