@haaaiawd/second-nature 0.1.18 → 0.1.20

package/runtime/guidance/outreach-draft-schema.d.ts

@@ -1,228 +1,228 @@
-/**
- * Outreach draft request contracts + zod validation (T6.1.1 / behavioral-guidance-system v5).
- *
- * Core logic: strict schema for control-plane → guidance handoff; GuidanceDraftPort documents async seam.
- * Test coverage: tests/unit/guidance/outreach-draft-schema.test.ts
- */
-import { z } from "zod";
-export declare const guidanceSourceRefSchema: z.ZodObject<{
-    id: z.ZodString;
-    kind: z.ZodEnum<{
-        platform_item: "platform_item";
-        workspace_artifact: "workspace_artifact";
-        decision_record: "decision_record";
-        user_anchor: "user_anchor";
-        connector_result: "connector_result";
-        host_report: "host_report";
-        fallback_artifact: "fallback_artifact";
-    }>;
-    uri: z.ZodString;
-    excerptHash: z.ZodOptional<z.ZodString>;
-    observedAt: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type GuidanceSourceRef = z.infer<typeof guidanceSourceRefSchema>;
-export declare const deliveryExpressionContextSchema: z.ZodObject<{
-    deliveryVerdict: z.ZodEnum<{
-        target_none: "target_none";
-        channel_missing: "channel_missing";
-        host_unsupported: "host_unsupported";
-        delivery_failed: "delivery_failed";
-        target_available: "target_available";
-    }>;
-    fallbackRef: z.ZodOptional<z.ZodString>;
-    wordingMode: z.ZodEnum<{
-        sendable: "sendable";
-        not_sent_fallback_candidate: "not_sent_fallback_candidate";
-    }>;
-}, z.core.$strip>;
-export declare const sceneGuidanceRequestSchema: z.ZodObject<{
-    requestId: z.ZodString;
-    sceneType: z.ZodEnum<{
-        outreach: "outreach";
-        explain: "explain";
-        social: "social";
-        quiet_reflection: "quiet_reflection";
-        user_reply_continuity: "user_reply_continuity";
-        fallback_candidate: "fallback_candidate";
-    }>;
-    runtimeScope: z.ZodEnum<{
-        rhythm: "rhythm";
-        user_reply: "user_reply";
-        user_task: "user_task";
-    }>;
-    rhythmWindowKind: z.ZodOptional<z.ZodEnum<{
-        quiet: "quiet";
-        social: "social";
-        work: "work";
-        exploration: "exploration";
-        reflection: "reflection";
-        maintenance: "maintenance";
-    }>>;
-    riskLevel: z.ZodEnum<{
-        medium: "medium";
-        low: "low";
-        high: "high";
-    }>;
-    sourceRefs: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        kind: z.ZodEnum<{
-            platform_item: "platform_item";
-            workspace_artifact: "workspace_artifact";
-            decision_record: "decision_record";
-            user_anchor: "user_anchor";
-            connector_result: "connector_result";
-            host_report: "host_report";
-            fallback_artifact: "fallback_artifact";
-        }>;
-        uri: z.ZodString;
-        excerptHash: z.ZodOptional<z.ZodString>;
-        observedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    deliveryContext: z.ZodOptional<z.ZodObject<{
-        deliveryVerdict: z.ZodEnum<{
-            target_none: "target_none";
-            channel_missing: "channel_missing";
-            host_unsupported: "host_unsupported";
-            delivery_failed: "delivery_failed";
-            target_available: "target_available";
-        }>;
-        fallbackRef: z.ZodOptional<z.ZodString>;
-        wordingMode: z.ZodEnum<{
-            sendable: "sendable";
-            not_sent_fallback_candidate: "not_sent_fallback_candidate";
-        }>;
-    }, z.core.$strip>>;
-    language: z.ZodOptional<z.ZodEnum<{
-        "en-US": "en-US";
-        "zh-CN": "zh-CN";
-    }>>;
-}, z.core.$strip>;
-export declare const outreachDraftRequestSchema: z.ZodObject<{
-    requestId: z.ZodString;
-    runtimeScope: z.ZodEnum<{
-        rhythm: "rhythm";
-        user_reply: "user_reply";
-        user_task: "user_task";
-    }>;
-    rhythmWindowKind: z.ZodOptional<z.ZodEnum<{
-        quiet: "quiet";
-        social: "social";
-        work: "work";
-        exploration: "exploration";
-        reflection: "reflection";
-        maintenance: "maintenance";
-    }>>;
-    riskLevel: z.ZodEnum<{
-        medium: "medium";
-        low: "low";
-        high: "high";
-    }>;
-    sourceRefs: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        kind: z.ZodEnum<{
-            platform_item: "platform_item";
-            workspace_artifact: "workspace_artifact";
-            decision_record: "decision_record";
-            user_anchor: "user_anchor";
-            connector_result: "connector_result";
-            host_report: "host_report";
-            fallback_artifact: "fallback_artifact";
-        }>;
-        uri: z.ZodString;
-        excerptHash: z.ZodOptional<z.ZodString>;
-        observedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    deliveryContext: z.ZodOptional<z.ZodObject<{
-        deliveryVerdict: z.ZodEnum<{
-            target_none: "target_none";
-            channel_missing: "channel_missing";
-            host_unsupported: "host_unsupported";
-            delivery_failed: "delivery_failed";
-            target_available: "target_available";
-        }>;
-        fallbackRef: z.ZodOptional<z.ZodString>;
-        wordingMode: z.ZodEnum<{
-            sendable: "sendable";
-            not_sent_fallback_candidate: "not_sent_fallback_candidate";
-        }>;
-    }, z.core.$strip>>;
-    language: z.ZodOptional<z.ZodEnum<{
-        "en-US": "en-US";
-        "zh-CN": "zh-CN";
-    }>>;
-    sceneType: z.ZodEnum<{
-        outreach: "outreach";
-        fallback_candidate: "fallback_candidate";
-    }>;
-    decisionId: z.ZodString;
-    candidateId: z.ZodString;
-    judgmentVerdict: z.ZodEnum<{
-        allow: "allow";
-        deny: "deny";
-        defer: "defer";
-    }>;
-    valueScore: z.ZodNumber;
-    interestRefs: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        kind: z.ZodEnum<{
-            platform_item: "platform_item";
-            workspace_artifact: "workspace_artifact";
-            decision_record: "decision_record";
-            user_anchor: "user_anchor";
-            connector_result: "connector_result";
-            host_report: "host_report";
-            fallback_artifact: "fallback_artifact";
-        }>;
-        uri: z.ZodString;
-        excerptHash: z.ZodOptional<z.ZodString>;
-        observedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type SceneGuidanceRequest = z.infer<typeof sceneGuidanceRequestSchema>;
-export type OutreachDraftRequest = z.infer<typeof outreachDraftRequestSchema>;
-export type DeliveryExpressionContext = z.infer<typeof deliveryExpressionContextSchema>;
-export declare function parseOutreachDraftRequest(input: unknown): OutreachDraftRequest;
-export declare function safeParseOutreachDraftRequest(input: unknown): z.ZodSafeParseResult<{
-    requestId: string;
-    runtimeScope: "rhythm" | "user_reply" | "user_task";
-    riskLevel: "medium" | "low" | "high";
-    sourceRefs: {
-        id: string;
-        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
-        uri: string;
-        excerptHash?: string | undefined;
-        observedAt?: string | undefined;
-    }[];
-    sceneType: "outreach" | "fallback_candidate";
-    decisionId: string;
-    candidateId: string;
-    judgmentVerdict: "allow" | "deny" | "defer";
-    valueScore: number;
-    interestRefs: {
-        id: string;
-        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
-        uri: string;
-        excerptHash?: string | undefined;
-        observedAt?: string | undefined;
-    }[];
-    rhythmWindowKind?: "quiet" | "social" | "work" | "exploration" | "reflection" | "maintenance" | undefined;
-    deliveryContext?: {
-        deliveryVerdict: "target_none" | "channel_missing" | "host_unsupported" | "delivery_failed" | "target_available";
-        wordingMode: "sendable" | "not_sent_fallback_candidate";
-        fallbackRef?: string | undefined;
-    } | undefined;
-    language?: "en-US" | "zh-CN" | undefined;
-}>;
-/** Async seam for generative outreach copy (implementation lives outside control-plane). */
-export interface GuidanceDraftPort {
-    draftOutreachMessage(request: OutreachDraftRequest): Promise<{
-        status: "ready";
-        draft: {
-            text: string;
-            deliveryWording: DeliveryExpressionContext["wordingMode"];
-        };
-    } | {
-        status: "unavailable";
-        reasons: string[];
-    }>;
-}
+/**
+ * Outreach draft request contracts + zod validation (T6.1.1 / behavioral-guidance-system v5).
+ *
+ * Core logic: strict schema for control-plane → guidance handoff; GuidanceDraftPort documents async seam.
+ * Test coverage: tests/unit/guidance/outreach-draft-schema.test.ts
+ */
+import { z } from "zod";
+export declare const guidanceSourceRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        platform_item: "platform_item";
+        workspace_artifact: "workspace_artifact";
+        decision_record: "decision_record";
+        user_anchor: "user_anchor";
+        connector_result: "connector_result";
+        host_report: "host_report";
+        fallback_artifact: "fallback_artifact";
+    }>;
+    uri: z.ZodString;
+    excerptHash: z.ZodOptional<z.ZodString>;
+    observedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GuidanceSourceRef = z.infer<typeof guidanceSourceRefSchema>;
+export declare const deliveryExpressionContextSchema: z.ZodObject<{
+    deliveryVerdict: z.ZodEnum<{
+        target_none: "target_none";
+        channel_missing: "channel_missing";
+        host_unsupported: "host_unsupported";
+        delivery_failed: "delivery_failed";
+        target_available: "target_available";
+    }>;
+    fallbackRef: z.ZodOptional<z.ZodString>;
+    wordingMode: z.ZodEnum<{
+        sendable: "sendable";
+        not_sent_fallback_candidate: "not_sent_fallback_candidate";
+    }>;
+}, z.core.$strip>;
+export declare const sceneGuidanceRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    sceneType: z.ZodEnum<{
+        outreach: "outreach";
+        explain: "explain";
+        social: "social";
+        quiet_reflection: "quiet_reflection";
+        user_reply_continuity: "user_reply_continuity";
+        fallback_candidate: "fallback_candidate";
+    }>;
+    runtimeScope: z.ZodEnum<{
+        rhythm: "rhythm";
+        user_reply: "user_reply";
+        user_task: "user_task";
+    }>;
+    rhythmWindowKind: z.ZodOptional<z.ZodEnum<{
+        quiet: "quiet";
+        social: "social";
+        work: "work";
+        exploration: "exploration";
+        reflection: "reflection";
+        maintenance: "maintenance";
+    }>>;
+    riskLevel: z.ZodEnum<{
+        medium: "medium";
+        low: "low";
+        high: "high";
+    }>;
+    sourceRefs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            platform_item: "platform_item";
+            workspace_artifact: "workspace_artifact";
+            decision_record: "decision_record";
+            user_anchor: "user_anchor";
+            connector_result: "connector_result";
+            host_report: "host_report";
+            fallback_artifact: "fallback_artifact";
+        }>;
+        uri: z.ZodString;
+        excerptHash: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    deliveryContext: z.ZodOptional<z.ZodObject<{
+        deliveryVerdict: z.ZodEnum<{
+            target_none: "target_none";
+            channel_missing: "channel_missing";
+            host_unsupported: "host_unsupported";
+            delivery_failed: "delivery_failed";
+            target_available: "target_available";
+        }>;
+        fallbackRef: z.ZodOptional<z.ZodString>;
+        wordingMode: z.ZodEnum<{
+            sendable: "sendable";
+            not_sent_fallback_candidate: "not_sent_fallback_candidate";
+        }>;
+    }, z.core.$strip>>;
+    language: z.ZodOptional<z.ZodEnum<{
+        "en-US": "en-US";
+        "zh-CN": "zh-CN";
+    }>>;
+}, z.core.$strip>;
+export declare const outreachDraftRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    runtimeScope: z.ZodEnum<{
+        rhythm: "rhythm";
+        user_reply: "user_reply";
+        user_task: "user_task";
+    }>;
+    rhythmWindowKind: z.ZodOptional<z.ZodEnum<{
+        quiet: "quiet";
+        social: "social";
+        work: "work";
+        exploration: "exploration";
+        reflection: "reflection";
+        maintenance: "maintenance";
+    }>>;
+    riskLevel: z.ZodEnum<{
+        medium: "medium";
+        low: "low";
+        high: "high";
+    }>;
+    sourceRefs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            platform_item: "platform_item";
+            workspace_artifact: "workspace_artifact";
+            decision_record: "decision_record";
+            user_anchor: "user_anchor";
+            connector_result: "connector_result";
+            host_report: "host_report";
+            fallback_artifact: "fallback_artifact";
+        }>;
+        uri: z.ZodString;
+        excerptHash: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    deliveryContext: z.ZodOptional<z.ZodObject<{
+        deliveryVerdict: z.ZodEnum<{
+            target_none: "target_none";
+            channel_missing: "channel_missing";
+            host_unsupported: "host_unsupported";
+            delivery_failed: "delivery_failed";
+            target_available: "target_available";
+        }>;
+        fallbackRef: z.ZodOptional<z.ZodString>;
+        wordingMode: z.ZodEnum<{
+            sendable: "sendable";
+            not_sent_fallback_candidate: "not_sent_fallback_candidate";
+        }>;
+    }, z.core.$strip>>;
+    language: z.ZodOptional<z.ZodEnum<{
+        "en-US": "en-US";
+        "zh-CN": "zh-CN";
+    }>>;
+    sceneType: z.ZodEnum<{
+        outreach: "outreach";
+        fallback_candidate: "fallback_candidate";
+    }>;
+    decisionId: z.ZodString;
+    candidateId: z.ZodString;
+    judgmentVerdict: z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+        defer: "defer";
+    }>;
+    valueScore: z.ZodNumber;
+    interestRefs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            platform_item: "platform_item";
+            workspace_artifact: "workspace_artifact";
+            decision_record: "decision_record";
+            user_anchor: "user_anchor";
+            connector_result: "connector_result";
+            host_report: "host_report";
+            fallback_artifact: "fallback_artifact";
+        }>;
+        uri: z.ZodString;
+        excerptHash: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SceneGuidanceRequest = z.infer<typeof sceneGuidanceRequestSchema>;
+export type OutreachDraftRequest = z.infer<typeof outreachDraftRequestSchema>;
+export type DeliveryExpressionContext = z.infer<typeof deliveryExpressionContextSchema>;
+export declare function parseOutreachDraftRequest(input: unknown): OutreachDraftRequest;
+export declare function safeParseOutreachDraftRequest(input: unknown): z.ZodSafeParseResult<{
+    requestId: string;
+    runtimeScope: "rhythm" | "user_reply" | "user_task";
+    riskLevel: "medium" | "low" | "high";
+    sourceRefs: {
+        id: string;
+        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+        uri: string;
+        excerptHash?: string | undefined;
+        observedAt?: string | undefined;
+    }[];
+    sceneType: "outreach" | "fallback_candidate";
+    decisionId: string;
+    candidateId: string;
+    judgmentVerdict: "allow" | "deny" | "defer";
+    valueScore: number;
+    interestRefs: {
+        id: string;
+        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+        uri: string;
+        excerptHash?: string | undefined;
+        observedAt?: string | undefined;
+    }[];
+    rhythmWindowKind?: "quiet" | "social" | "work" | "exploration" | "reflection" | "maintenance" | undefined;
+    deliveryContext?: {
+        deliveryVerdict: "target_none" | "channel_missing" | "host_unsupported" | "delivery_failed" | "target_available";
+        wordingMode: "sendable" | "not_sent_fallback_candidate";
+        fallbackRef?: string | undefined;
+    } | undefined;
+    language?: "en-US" | "zh-CN" | undefined;
+}>;
+/** Async seam for generative outreach copy (implementation lives outside control-plane). */
+export interface GuidanceDraftPort {
+    draftOutreachMessage(request: OutreachDraftRequest): Promise<{
+        status: "ready";
+        draft: {
+            text: string;
+            deliveryWording: DeliveryExpressionContext["wordingMode"];
+        };
+    } | {
+        status: "unavailable";
+        reasons: string[];
+    }>;
+}

package/runtime/guidance/outreach-draft-schema.js

@@ -1,80 +1,80 @@
-/**
- * Outreach draft request contracts + zod validation (T6.1.1 / behavioral-guidance-system v5).
- *
- * Core logic: strict schema for control-plane → guidance handoff; GuidanceDraftPort documents async seam.
- * Test coverage: tests/unit/guidance/outreach-draft-schema.test.ts
- */
-import { z } from "zod";
-const sourceRefKindSchema = z.enum([
-    "platform_item",
-    "workspace_artifact",
-    "decision_record",
-    "user_anchor",
-    "connector_result",
-    "host_report",
-    "fallback_artifact",
-]);
-export const guidanceSourceRefSchema = z.object({
-    id: z.string().min(1),
-    kind: sourceRefKindSchema,
-    uri: z.string().min(1),
-    excerptHash: z.string().optional(),
-    observedAt: z.string().optional(),
-});
-export const deliveryExpressionContextSchema = z.object({
-    deliveryVerdict: z.enum([
-        "target_available",
-        "target_none",
-        "channel_missing",
-        "host_unsupported",
-        "delivery_failed",
-    ]),
-    fallbackRef: z.string().optional(),
-    wordingMode: z.enum(["sendable", "not_sent_fallback_candidate"]),
-});
-const guidanceSceneTypeSchema = z.enum([
-    "outreach",
-    "quiet_reflection",
-    "social",
-    "explain",
-    "user_reply_continuity",
-    "fallback_candidate",
-]);
-const runtimeScopeSchema = z.enum(["rhythm", "user_task", "user_reply"]);
-const riskLevelSchema = z.enum(["low", "medium", "high"]);
-export const sceneGuidanceRequestSchema = z.object({
-    requestId: z.string().min(1),
-    sceneType: guidanceSceneTypeSchema,
-    runtimeScope: runtimeScopeSchema,
-    rhythmWindowKind: z
-        .enum(["work", "exploration", "social", "quiet", "reflection", "maintenance"])
-        .optional(),
-    riskLevel: riskLevelSchema,
-    sourceRefs: z.array(guidanceSourceRefSchema),
-    deliveryContext: deliveryExpressionContextSchema.optional(),
-    language: z.enum(["zh-CN", "en-US"]).optional(),
-});
-export const outreachDraftRequestSchema = sceneGuidanceRequestSchema
-    .extend({
-    sceneType: z.enum(["outreach", "fallback_candidate"]),
-    decisionId: z.string().min(1),
-    candidateId: z.string().min(1),
-    judgmentVerdict: z.enum(["allow", "deny", "defer"]),
-    valueScore: z.number(),
-    interestRefs: z.array(guidanceSourceRefSchema),
-})
-    .superRefine((val, ctx) => {
-    if (!val.deliveryContext) {
-        ctx.addIssue({
-            code: "custom",
-            message: "outreach_draft_requires_delivery_context",
-            path: ["deliveryContext"],
-        });
-    }
-});
-export function parseOutreachDraftRequest(input) {
-    return outreachDraftRequestSchema.parse(input);
-}
-export function safeParseOutreachDraftRequest(input) {
-    return outreachDraftRequestSchema.safeParse(input);
-}
+/**
+ * Outreach draft request contracts + zod validation (T6.1.1 / behavioral-guidance-system v5).
+ *
+ * Core logic: strict schema for control-plane → guidance handoff; GuidanceDraftPort documents async seam.
+ * Test coverage: tests/unit/guidance/outreach-draft-schema.test.ts
+ */
+import { z } from "zod";
+const sourceRefKindSchema = z.enum([
+    "platform_item",
+    "workspace_artifact",
+    "decision_record",
+    "user_anchor",
+    "connector_result",
+    "host_report",
+    "fallback_artifact",
+]);
+export const guidanceSourceRefSchema = z.object({
+    id: z.string().min(1),
+    kind: sourceRefKindSchema,
+    uri: z.string().min(1),
+    excerptHash: z.string().optional(),
+    observedAt: z.string().optional(),
+});
+export const deliveryExpressionContextSchema = z.object({
+    deliveryVerdict: z.enum([
+        "target_available",
+        "target_none",
+        "channel_missing",
+        "host_unsupported",
+        "delivery_failed",
+    ]),
+    fallbackRef: z.string().optional(),
+    wordingMode: z.enum(["sendable", "not_sent_fallback_candidate"]),
+});
+const guidanceSceneTypeSchema = z.enum([
+    "outreach",
+    "quiet_reflection",
+    "social",
+    "explain",
+    "user_reply_continuity",
+    "fallback_candidate",
+]);
+const runtimeScopeSchema = z.enum(["rhythm", "user_task", "user_reply"]);
+const riskLevelSchema = z.enum(["low", "medium", "high"]);
+export const sceneGuidanceRequestSchema = z.object({
+    requestId: z.string().min(1),
+    sceneType: guidanceSceneTypeSchema,
+    runtimeScope: runtimeScopeSchema,
+    rhythmWindowKind: z
+        .enum(["work", "exploration", "social", "quiet", "reflection", "maintenance"])
+        .optional(),
+    riskLevel: riskLevelSchema,
+    sourceRefs: z.array(guidanceSourceRefSchema),
+    deliveryContext: deliveryExpressionContextSchema.optional(),
+    language: z.enum(["zh-CN", "en-US"]).optional(),
+});
+export const outreachDraftRequestSchema = sceneGuidanceRequestSchema
+    .extend({
+    sceneType: z.enum(["outreach", "fallback_candidate"]),
+    decisionId: z.string().min(1),
+    candidateId: z.string().min(1),
+    judgmentVerdict: z.enum(["allow", "deny", "defer"]),
+    valueScore: z.number(),
+    interestRefs: z.array(guidanceSourceRefSchema),
+})
+    .superRefine((val, ctx) => {
+    if (!val.deliveryContext) {
+        ctx.addIssue({
+            code: "custom",
+            message: "outreach_draft_requires_delivery_context",
+            path: ["deliveryContext"],
+        });
+    }
+});
+export function parseOutreachDraftRequest(input) {
+    return outreachDraftRequestSchema.parse(input);
+}
+export function safeParseOutreachDraftRequest(input) {
+    return outreachDraftRequestSchema.safeParse(input);
+}

package/runtime/observability/audit/append-only-audit-store.d.ts

@@ -1,14 +1,14 @@
-/**
- * In-memory append-only audit store with hash-chain verification hooks.
- *
- * Core logic: reject broken previousHash links; expose ordered envelopes for tests / local tooling.
- *
- * Test coverage: tests/unit/observability/audit-envelope.test.ts
- */
-import type { AuditEnvelope } from "./audit-envelope.js";
-export declare class AppendOnlyAuditStore {
-    private readonly events;
-    append<T>(envelope: AuditEnvelope<T>): void;
-    list(): readonly AuditEnvelope<unknown>[];
-    lastRecordHash(): string | undefined;
-}
+/**
+ * In-memory append-only audit store with hash-chain verification hooks.
+ *
+ * Core logic: reject broken previousHash links; expose ordered envelopes for tests / local tooling.
+ *
+ * Test coverage: tests/unit/observability/audit-envelope.test.ts
+ */
+import type { AuditEnvelope } from "./audit-envelope.js";
+export declare class AppendOnlyAuditStore {
+    private readonly events;
+    append<T>(envelope: AuditEnvelope<T>): void;
+    list(): readonly AuditEnvelope<unknown>[];
+    lastRecordHash(): string | undefined;
+}