@haaaiawd/second-nature 0.1.17 → 0.1.18

package/runtime/cli/explain/format-explanation.js

@@ -1,12 +1,12 @@
-export function formatExplanation(model) {
-    return {
-        subjectType: model.subjectType,
-        conclusion: model.conclusion,
-        keyFactors: model.keyFactors,
-        evidenceRefs: model.evidenceRefs,
-        requiredUserInput: model.requiredUserInput,
-        nextStep: model.nextStep,
-        warnings: model.warnings,
-        relatedAuditEventIds: model.relatedAuditEventIds,
-    };
-}
+export function formatExplanation(model) {
+    return {
+        subjectType: model.subjectType,
+        conclusion: model.conclusion,
+        keyFactors: model.keyFactors,
+        evidenceRefs: model.evidenceRefs,
+        requiredUserInput: model.requiredUserInput,
+        nextStep: model.nextStep,
+        warnings: model.warnings,
+        relatedAuditEventIds: model.relatedAuditEventIds,
+    };
+}

package/runtime/cli/explain/resolve-subject.js

@@ -1,41 +1,41 @@
-function splitSubject(raw) {
-    const [prefix, ...rest] = raw.split(":");
-    return {
-        prefix: (prefix ?? "").trim(),
-        id: rest.join(":").trim(),
-    };
-}
-export function resolveExplainSubject(raw) {
-    const { prefix, id } = splitSubject(raw);
-    if (!id) {
-        throw new Error("explain_subject_requires_id");
-    }
-    if (prefix === "decision") {
-        return { kind: "decision", id };
-    }
-    if (prefix === "platform") {
-        return { kind: "platform-selection", id };
-    }
-    if (prefix === "outreach") {
-        return { kind: "outreach", id };
-    }
-    if (prefix === "soul") {
-        return { kind: "soul-change", id };
-    }
-    if (prefix === "fallback") {
-        return { kind: "fallback", id };
-    }
-    if (prefix === "probe") {
-        return { kind: "probe", id };
-    }
-    if (prefix === "report") {
-        return { kind: "report", id };
-    }
-    if (prefix === "delivery") {
-        return { kind: "delivery", id };
-    }
-    if (prefix === "source" || prefix === "source_ref") {
-        return { kind: "source_ref", id };
-    }
-    throw new Error("explain_subject_unsupported");
-}
+function splitSubject(raw) {
+    const [prefix, ...rest] = raw.split(":");
+    return {
+        prefix: (prefix ?? "").trim(),
+        id: rest.join(":").trim(),
+    };
+}
+export function resolveExplainSubject(raw) {
+    const { prefix, id } = splitSubject(raw);
+    if (!id) {
+        throw new Error("explain_subject_requires_id");
+    }
+    if (prefix === "decision") {
+        return { kind: "decision", id };
+    }
+    if (prefix === "platform") {
+        return { kind: "platform-selection", id };
+    }
+    if (prefix === "outreach") {
+        return { kind: "outreach", id };
+    }
+    if (prefix === "soul") {
+        return { kind: "soul-change", id };
+    }
+    if (prefix === "fallback") {
+        return { kind: "fallback", id };
+    }
+    if (prefix === "probe") {
+        return { kind: "probe", id };
+    }
+    if (prefix === "report") {
+        return { kind: "report", id };
+    }
+    if (prefix === "delivery") {
+        return { kind: "delivery", id };
+    }
+    if (prefix === "source" || prefix === "source_ref") {
+        return { kind: "source_ref", id };
+    }
+    throw new Error("explain_subject_unsupported");
+}

package/runtime/cli/host-capability/classify-delivery.d.ts

@@ -1,14 +1,14 @@
-/**
- * Normalizes host-reported delivery signals into DeliveryCapabilityStatus (cli-system).
- */
-import type { DeliveryCapabilityStatus } from "./types.js";
-export interface ClassifyDeliveryCapabilityInput {
-    /** Host-reported delivery channel / target hint */
-    rawTarget?: string | null;
-    channel?: string | null;
-    /** When false, host API for delivery is not reachable */
-    apiAvailable?: boolean;
-    /** When true, host explicitly reports unsupported delivery surface */
-    hostUnsupported?: boolean;
-}
-export declare function classifyDeliveryCapability(input: ClassifyDeliveryCapabilityInput): DeliveryCapabilityStatus;
+/**
+ * Normalizes host-reported delivery signals into DeliveryCapabilityStatus (cli-system).
+ */
+import type { DeliveryCapabilityStatus } from "./types.js";
+export interface ClassifyDeliveryCapabilityInput {
+    /** Host-reported delivery channel / target hint */
+    rawTarget?: string | null;
+    channel?: string | null;
+    /** When false, host API for delivery is not reachable */
+    apiAvailable?: boolean;
+    /** When true, host explicitly reports unsupported delivery surface */
+    hostUnsupported?: boolean;
+}
+export declare function classifyDeliveryCapability(input: ClassifyDeliveryCapabilityInput): DeliveryCapabilityStatus;

package/runtime/cli/host-capability/classify-delivery.js

@@ -1,20 +1,20 @@
-export function classifyDeliveryCapability(input) {
-    if (input.hostUnsupported) {
-        return "host_unsupported";
-    }
-    if (input.apiAvailable === false) {
-        return "host_api_unavailable";
-    }
-    const target = (input.rawTarget ?? "").trim().toLowerCase();
-    if (target === "none" || target === "") {
-        return "target_none";
-    }
-    const ch = (input.channel ?? "").trim();
-    if (!ch) {
-        return "channel_missing";
-    }
-    if (target === "unknown" || target === "unspecified") {
-        return "unknown";
-    }
-    return "target_available";
-}
+export function classifyDeliveryCapability(input) {
+    if (input.hostUnsupported) {
+        return "host_unsupported";
+    }
+    if (input.apiAvailable === false) {
+        return "host_api_unavailable";
+    }
+    const target = (input.rawTarget ?? "").trim().toLowerCase();
+    if (target === "none" || target === "") {
+        return "target_none";
+    }
+    const ch = (input.channel ?? "").trim();
+    if (!ch) {
+        return "channel_missing";
+    }
+    if (target === "unknown" || target === "unspecified") {
+        return "unknown";
+    }
+    return "target_available";
+}

package/runtime/cli/host-capability/probe-host-capability.d.ts

@@ -1,2 +1,2 @@
-import type { HostCapabilityProbeOptions, HostCapabilityReport } from "./types.js";
-export declare function probeHostCapability(options: HostCapabilityProbeOptions): HostCapabilityReport;
+import type { HostCapabilityProbeOptions, HostCapabilityReport } from "./types.js";
+export declare function probeHostCapability(options: HostCapabilityProbeOptions): HostCapabilityReport;

package/runtime/cli/host-capability/probe-host-capability.js

@@ -1,58 +1,58 @@
-/**
- * OpenClaw host capability probe — aggregates adapter checks into HostCapabilityReport.
- */
-import * as crypto from "node:crypto";
-function mergeEvidenceRefs(...groups) {
-    const seen = new Set();
-    const out = [];
-    for (const group of groups) {
-        for (const ref of group) {
-            const key = `${ref.kind}:${ref.id}`;
-            if (!seen.has(key)) {
-                seen.add(key);
-                out.push(ref);
-            }
-        }
-    }
-    return out;
-}
-export function probeHostCapability(options) {
-    const { adapter, docLinks, docCheckedAt, hostVersion, observedVersion } = options;
-    const generatedAt = new Date().toISOString();
-    const pluginLoad = adapter.checkPluginLoad();
-    const heartbeatBridge = adapter.checkHeartbeatBridge();
-    const heartbeatToolInvocation = adapter.checkHeartbeatToolInvocation();
-    const delivery = adapter.checkDeliveryTarget();
-    const deliveryTarget = delivery.status;
-    const ackDropBehavior = adapter.checkAckDropBehavior();
-    const hookSupport = adapter.checkHookSupport();
-    const conflictRecords = [];
-    if (delivery.reason === "docs_vs_observed_mismatch" && docLinks.length > 0) {
-        const doc = docLinks[0];
-        conflictRecords.push({
-            capability: "delivery_target",
-            documentedBehavior: doc.documentedBehavior,
-            observedBehavior: deliveryTarget,
-            hostVersion,
-            docUrl: doc.url,
-        });
-    }
-    const evidenceRefs = mergeEvidenceRefs(pluginLoad.evidenceRefs, heartbeatBridge.evidenceRefs, heartbeatToolInvocation.evidenceRefs, delivery.evidenceRefs, ackDropBehavior.evidenceRefs, ...hookSupport.map((h) => h.evidenceRefs));
-    return {
-        reportId: crypto.randomUUID(),
-        generatedAt,
-        hostVersion,
-        observedVersion,
-        docLinks,
-        docCheckedAt,
-        pluginLoad,
-        heartbeatBridge,
-        heartbeatToolInvocation,
-        deliveryTarget,
-        ackDropBehavior,
-        hookSupport,
-        evidenceRefs,
-        conflictRecords,
-        recommendedNextStep: conflictRecords.length > 0 ? "reconcile_docs_vs_observed" : undefined,
-    };
-}
+/**
+ * OpenClaw host capability probe — aggregates adapter checks into HostCapabilityReport.
+ */
+import * as crypto from "node:crypto";
+function mergeEvidenceRefs(...groups) {
+    const seen = new Set();
+    const out = [];
+    for (const group of groups) {
+        for (const ref of group) {
+            const key = `${ref.kind}:${ref.id}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                out.push(ref);
+            }
+        }
+    }
+    return out;
+}
+export function probeHostCapability(options) {
+    const { adapter, docLinks, docCheckedAt, hostVersion, observedVersion } = options;
+    const generatedAt = new Date().toISOString();
+    const pluginLoad = adapter.checkPluginLoad();
+    const heartbeatBridge = adapter.checkHeartbeatBridge();
+    const heartbeatToolInvocation = adapter.checkHeartbeatToolInvocation();
+    const delivery = adapter.checkDeliveryTarget();
+    const deliveryTarget = delivery.status;
+    const ackDropBehavior = adapter.checkAckDropBehavior();
+    const hookSupport = adapter.checkHookSupport();
+    const conflictRecords = [];
+    if (delivery.reason === "docs_vs_observed_mismatch" && docLinks.length > 0) {
+        const doc = docLinks[0];
+        conflictRecords.push({
+            capability: "delivery_target",
+            documentedBehavior: doc.documentedBehavior,
+            observedBehavior: deliveryTarget,
+            hostVersion,
+            docUrl: doc.url,
+        });
+    }
+    const evidenceRefs = mergeEvidenceRefs(pluginLoad.evidenceRefs, heartbeatBridge.evidenceRefs, heartbeatToolInvocation.evidenceRefs, delivery.evidenceRefs, ackDropBehavior.evidenceRefs, ...hookSupport.map((h) => h.evidenceRefs));
+    return {
+        reportId: crypto.randomUUID(),
+        generatedAt,
+        hostVersion,
+        observedVersion,
+        docLinks,
+        docCheckedAt,
+        pluginLoad,
+        heartbeatBridge,
+        heartbeatToolInvocation,
+        deliveryTarget,
+        ackDropBehavior,
+        hookSupport,
+        evidenceRefs,
+        conflictRecords,
+        recommendedNextStep: conflictRecords.length > 0 ? "reconcile_docs_vs_observed" : undefined,
+    };
+}

package/runtime/cli/host-capability/record-host-capability.d.ts

@@ -1,6 +1,6 @@
-/**
- * Persist HostCapabilityReport into observability SQLite (T1.1.2).
- */
-import type { ObservabilityDatabase } from "../../observability/db/index.js";
-import type { HostCapabilityReport } from "./types.js";
-export declare function recordHostCapability(db: ObservabilityDatabase, report: HostCapabilityReport): Promise<void>;
+/**
+ * Persist HostCapabilityReport into observability SQLite (T1.1.2).
+ */
+import type { ObservabilityDatabase } from "../../observability/db/index.js";
+import type { HostCapabilityReport } from "./types.js";
+export declare function recordHostCapability(db: ObservabilityDatabase, report: HostCapabilityReport): Promise<void>;

package/runtime/cli/host-capability/record-host-capability.js

@@ -1,14 +1,14 @@
-import { hostCapabilityReports } from "../../observability/db/schema/host-capability-reports.js";
-export async function recordHostCapability(db, report) {
-    await db.db.insert(hostCapabilityReports).values({
-        reportId: report.reportId,
-        generatedAt: report.generatedAt,
-        hostVersion: report.hostVersion ?? null,
-        observedVersion: report.observedVersion ?? null,
-        docCheckedAt: report.docCheckedAt,
-        docLinksJson: JSON.stringify(report.docLinks),
-        deliveryTarget: report.deliveryTarget,
-        conflictRecordsJson: JSON.stringify(report.conflictRecords),
-        fullReportJson: JSON.stringify(report),
-    });
-}
+import { hostCapabilityReports } from "../../observability/db/schema/host-capability-reports.js";
+export async function recordHostCapability(db, report) {
+    await db.db.insert(hostCapabilityReports).values({
+        reportId: report.reportId,
+        generatedAt: report.generatedAt,
+        hostVersion: report.hostVersion ?? null,
+        observedVersion: report.observedVersion ?? null,
+        docCheckedAt: report.docCheckedAt,
+        docLinksJson: JSON.stringify(report.docLinks),
+        deliveryTarget: report.deliveryTarget,
+        conflictRecordsJson: JSON.stringify(report.conflictRecords),
+        fullReportJson: JSON.stringify(report),
+    });
+}

package/runtime/cli/host-capability/types.d.ts

@@ -1,71 +1,71 @@
-/**
- * Host capability probe contracts (cli-system v5 / ADR-007).
- *
- * Test coverage: tests/unit/cli/host-capability.test.ts, tests/integration/cli/host-capability-probe.test.ts
- */
-export type DeliveryCapabilityStatus = "target_available" | "target_none" | "channel_missing" | "host_api_unavailable" | "host_unsupported" | "unknown";
-export type CapabilityVerdict = "pass" | "fail" | "unknown" | "not_applicable";
-export interface SourceRef {
-    id: string;
-    kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
-    uri: string;
-    excerptHash?: string;
-    observedAt?: string;
-}
-export interface HostCapabilityDocReference {
-    title: string;
-    url: string;
-    checkedAt: string;
-    documentedBehavior: string;
-}
-export interface HostCapabilityConflictRecord {
-    capability: string;
-    documentedBehavior: string;
-    observedBehavior: string;
-    hostVersion?: string;
-    docUrl?: string;
-}
-export interface CapabilityCheckResult {
-    name: string;
-    verdict: CapabilityVerdict;
-    observedAt: string;
-    reason?: string;
-    evidenceRefs: SourceRef[];
-}
-export interface HostCapabilityReport {
-    reportId: string;
-    generatedAt: string;
-    hostVersion?: string;
-    observedVersion?: string;
-    docLinks: HostCapabilityDocReference[];
-    docCheckedAt: string;
-    pluginLoad: CapabilityCheckResult;
-    heartbeatBridge: CapabilityCheckResult;
-    heartbeatToolInvocation: CapabilityCheckResult;
-    deliveryTarget: DeliveryCapabilityStatus;
-    ackDropBehavior: CapabilityCheckResult;
-    hookSupport: CapabilityCheckResult[];
-    evidenceRefs: SourceRef[];
-    conflictRecords: HostCapabilityConflictRecord[];
-    recommendedNextStep?: string;
-}
-export interface HostCapabilityProbeOptions {
-    adapter: HostCapabilityAdapter;
-    docLinks: HostCapabilityDocReference[];
-    docCheckedAt: string;
-    hostVersion?: string;
-    observedVersion?: string;
-}
-export interface HostCapabilityAdapter {
-    checkPluginLoad(): CapabilityCheckResult;
-    checkHeartbeatBridge(): CapabilityCheckResult;
-    checkHeartbeatToolInvocation(): CapabilityCheckResult;
-    /** Return normalized delivery capability as observed on the host */
-    checkDeliveryTarget(): {
-        status: DeliveryCapabilityStatus;
-        evidenceRefs: SourceRef[];
-        reason?: string;
-    };
-    checkAckDropBehavior(): CapabilityCheckResult;
-    checkHookSupport(): CapabilityCheckResult[];
-}
+/**
+ * Host capability probe contracts (cli-system v5 / ADR-007).
+ *
+ * Test coverage: tests/unit/cli/host-capability.test.ts, tests/integration/cli/host-capability-probe.test.ts
+ */
+export type DeliveryCapabilityStatus = "target_available" | "target_none" | "channel_missing" | "host_api_unavailable" | "host_unsupported" | "unknown";
+export type CapabilityVerdict = "pass" | "fail" | "unknown" | "not_applicable";
+export interface SourceRef {
+    id: string;
+    kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+    uri: string;
+    excerptHash?: string;
+    observedAt?: string;
+}
+export interface HostCapabilityDocReference {
+    title: string;
+    url: string;
+    checkedAt: string;
+    documentedBehavior: string;
+}
+export interface HostCapabilityConflictRecord {
+    capability: string;
+    documentedBehavior: string;
+    observedBehavior: string;
+    hostVersion?: string;
+    docUrl?: string;
+}
+export interface CapabilityCheckResult {
+    name: string;
+    verdict: CapabilityVerdict;
+    observedAt: string;
+    reason?: string;
+    evidenceRefs: SourceRef[];
+}
+export interface HostCapabilityReport {
+    reportId: string;
+    generatedAt: string;
+    hostVersion?: string;
+    observedVersion?: string;
+    docLinks: HostCapabilityDocReference[];
+    docCheckedAt: string;
+    pluginLoad: CapabilityCheckResult;
+    heartbeatBridge: CapabilityCheckResult;
+    heartbeatToolInvocation: CapabilityCheckResult;
+    deliveryTarget: DeliveryCapabilityStatus;
+    ackDropBehavior: CapabilityCheckResult;
+    hookSupport: CapabilityCheckResult[];
+    evidenceRefs: SourceRef[];
+    conflictRecords: HostCapabilityConflictRecord[];
+    recommendedNextStep?: string;
+}
+export interface HostCapabilityProbeOptions {
+    adapter: HostCapabilityAdapter;
+    docLinks: HostCapabilityDocReference[];
+    docCheckedAt: string;
+    hostVersion?: string;
+    observedVersion?: string;
+}
+export interface HostCapabilityAdapter {
+    checkPluginLoad(): CapabilityCheckResult;
+    checkHeartbeatBridge(): CapabilityCheckResult;
+    checkHeartbeatToolInvocation(): CapabilityCheckResult;
+    /** Return normalized delivery capability as observed on the host */
+    checkDeliveryTarget(): {
+        status: DeliveryCapabilityStatus;
+        evidenceRefs: SourceRef[];
+        reason?: string;
+    };
+    checkAckDropBehavior(): CapabilityCheckResult;
+    checkHookSupport(): CapabilityCheckResult[];
+}

package/runtime/cli/host-capability/types.js

@@ -1,6 +1,6 @@
-/**
- * Host capability probe contracts (cli-system v5 / ADR-007).
- *
- * Test coverage: tests/unit/cli/host-capability.test.ts, tests/integration/cli/host-capability-probe.test.ts
- */
-export {};
+/**
+ * Host capability probe contracts (cli-system v5 / ADR-007).
+ *
+ * Test coverage: tests/unit/cli/host-capability.test.ts, tests/integration/cli/host-capability-probe.test.ts
+ */
+export {};

package/runtime/cli/host-smoke/run-host-smoke.d.ts

@@ -1,2 +1,2 @@
-import type { HostSmokePlan, HostSmokeReport } from "./types.js";
-export declare function runHostSmoke(plan: HostSmokePlan): Promise<HostSmokeReport>;
+import type { HostSmokePlan, HostSmokeReport } from "./types.js";
+export declare function runHostSmoke(plan: HostSmokePlan): Promise<HostSmokeReport>;

package/runtime/cli/host-smoke/run-host-smoke.js

@@ -1,40 +1,40 @@
-/**
- * Reproducible host smoke runner (T1.3.1). Uses transcript fixtures — no live OpenClaw in unit/integration path.
- *
- * Core logic: evaluate `heartbeat_tool_invocation` by substring match for heartbeat_check / second_nature_ops heartbeat surface.
- */
-import * as crypto from "node:crypto";
-function evalHeartbeatToolInvocation(c) {
-    const hasHeartbeatCheck = c.toolInvocations.some((t) => /heartbeat_check|second_nature_ops\s*\(\s*\{[^}]*heartbeat_check|command\s*:\s*["']heartbeat_check["']/i.test(t));
-    if (hasHeartbeatCheck) {
-        return { caseType: c.type, status: "pass", reasons: [] };
-    }
-    return { caseType: c.type, status: "fail", reasons: ["heartbeat_tool_not_invoked"] };
-}
-function evalDocsConflict(c) {
-    if (c.observedBehavior.trim() === c.docExpectation.trim()) {
-        return { caseType: c.type, status: "pass", reasons: [] };
-    }
-    return {
-        caseType: c.type,
-        status: "fail",
-        reasons: ["docs_vs_observed_conflict", `expected:${c.docExpectation}`, `observed:${c.observedBehavior}`],
-    };
-}
-function evalCase(c) {
-    if (c.type === "heartbeat_tool_invocation") {
-        return evalHeartbeatToolInvocation(c);
-    }
-    return evalDocsConflict(c);
-}
-export async function runHostSmoke(plan) {
-    const results = plan.cases.map((c) => evalCase(c));
-    return {
-        reportId: crypto.randomUUID(),
-        generatedAt: new Date().toISOString(),
-        results,
-        docLinks: plan.docLinks,
-        docCheckedAt: plan.docCheckedAt,
-        hostVersion: plan.hostVersion,
-    };
-}
+/**
+ * Reproducible host smoke runner (T1.3.1). Uses transcript fixtures — no live OpenClaw in unit/integration path.
+ *
+ * Core logic: evaluate `heartbeat_tool_invocation` by substring match for heartbeat_check / second_nature_ops heartbeat surface.
+ */
+import * as crypto from "node:crypto";
+function evalHeartbeatToolInvocation(c) {
+    const hasHeartbeatCheck = c.toolInvocations.some((t) => /heartbeat_check|second_nature_ops\s*\(\s*\{[^}]*heartbeat_check|command\s*:\s*["']heartbeat_check["']/i.test(t));
+    if (hasHeartbeatCheck) {
+        return { caseType: c.type, status: "pass", reasons: [] };
+    }
+    return { caseType: c.type, status: "fail", reasons: ["heartbeat_tool_not_invoked"] };
+}
+function evalDocsConflict(c) {
+    if (c.observedBehavior.trim() === c.docExpectation.trim()) {
+        return { caseType: c.type, status: "pass", reasons: [] };
+    }
+    return {
+        caseType: c.type,
+        status: "fail",
+        reasons: ["docs_vs_observed_conflict", `expected:${c.docExpectation}`, `observed:${c.observedBehavior}`],
+    };
+}
+function evalCase(c) {
+    if (c.type === "heartbeat_tool_invocation") {
+        return evalHeartbeatToolInvocation(c);
+    }
+    return evalDocsConflict(c);
+}
+export async function runHostSmoke(plan) {
+    const results = plan.cases.map((c) => evalCase(c));
+    return {
+        reportId: crypto.randomUUID(),
+        generatedAt: new Date().toISOString(),
+        results,
+        docLinks: plan.docLinks,
+        docCheckedAt: plan.docCheckedAt,
+        hostVersion: plan.hostVersion,
+    };
+}