@haaaiawd/second-nature 0.1.50 → 0.2.0

package/dist/tests/integration/cli/host-capability-probe.test.js

@@ -1,37 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { probeHostCapability, recordHostCapability } from "../../../src/cli/index.js";
-import { createObservabilityDatabase } from "../../../src/observability/db/index.js";
-import { hostCapabilityReports } from "../../../src/observability/db/schema/host-capability-reports.js";
-test("T1.1.2 recordHostCapability persists probe report", async () => {
-    const obs = createObservabilityDatabase(":memory:");
-    const now = new Date().toISOString();
-    const ref = (id) => [{ id, kind: "host_report", uri: `sn://${id}` }];
-    const adapter = {
-        checkPluginLoad: () => ({ name: "plugin_load", verdict: "pass", observedAt: now, evidenceRefs: ref("p1") }),
-        checkHeartbeatBridge: () => ({ name: "heartbeat_bridge", verdict: "pass", observedAt: now, evidenceRefs: ref("h1") }),
-        checkHeartbeatToolInvocation: () => ({
-            name: "heartbeat_tool_invocation",
-            verdict: "fail",
-            observedAt: now,
-            evidenceRefs: ref("t1"),
-        }),
-        checkDeliveryTarget: () => ({ status: "target_available", evidenceRefs: ref("d1") }),
-        checkAckDropBehavior: () => ({ name: "ack_drop", verdict: "unknown", observedAt: now, evidenceRefs: [] }),
-        checkHookSupport: () => [],
-    };
-    const report = probeHostCapability({
-        adapter,
-        docLinks: [],
-        docCheckedAt: now,
-        hostVersion: "1.0",
-    });
-    await recordHostCapability(obs, report);
-    const rows = await obs.db.select().from(hostCapabilityReports);
-    assert.equal(rows.length, 1);
-    assert.equal(rows[0].reportId, report.reportId);
-    assert.equal(rows[0].deliveryTarget, "target_available");
-    const full = JSON.parse(rows[0].fullReportJson);
-    assert.equal(full.heartbeatToolInvocation.verdict, "fail");
-    obs.close();
-});

package/dist/tests/integration/cli/host-smoke-heartbeat-tool.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/cli/host-smoke-heartbeat-tool.test.js

@@ -1,34 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { runHostSmoke } from "../../../src/cli/host-smoke/run-host-smoke.js";
-test("T1.3.1 heartbeat_tool_invocation — pass when transcript invokes heartbeat_check", async () => {
-    const report = await runHostSmoke({
-        cases: [
-            {
-                type: "heartbeat_tool_invocation",
-                toolInvocations: ['second_nature_ops({ command: "heartbeat_check" })'],
-            },
-        ],
-    });
-    assert.equal(report.results[0]?.status, "pass");
-});
-test("T1.3.1 heartbeat_tool_not_invoked when tool missing", async () => {
-    const report = await runHostSmoke({
-        cases: [{ type: "heartbeat_tool_invocation", toolInvocations: ["some_other_tool()"] }],
-    });
-    assert.equal(report.results[0]?.status, "fail");
-    assert.ok(report.results[0]?.reasons.includes("heartbeat_tool_not_invoked"));
-});
-test("T1.3.1 docs_vs_observed_conflict fixture", async () => {
-    const report = await runHostSmoke({
-        cases: [
-            {
-                type: "docs_vs_observed_conflict",
-                docExpectation: "must_invoke_heartbeat_check",
-                observedBehavior: "skipped_tool",
-            },
-        ],
-    });
-    assert.equal(report.results[0]?.status, "fail");
-    assert.ok(report.results[0]?.reasons.some((r) => r.includes("docs_vs_observed")));
-});

package/dist/tests/integration/cli/plugin-packaging-walkthrough.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/cli/plugin-packaging-walkthrough.test.js

@@ -1,79 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import fs from "node:fs";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-const root = process.cwd();
-function readJson(filePath) {
-    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
-}
-function runSmoke(mode) {
-    const result = spawnSync(process.execPath, ["dist/scripts/plugin-smoke-check.js", mode], {
-        cwd: root,
-        encoding: "utf-8",
-    });
-    assert.equal(result.status, 0, `smoke check should pass for ${mode}: ${result.stderr || result.stdout}`);
-    return JSON.parse(result.stdout);
-}
-test("T5.3.1 plugin package + manifest are discoverable for host loading", () => {
-    const pluginPkgPath = path.join(root, "plugin", "package.json");
-    const manifestPath = path.join(root, "plugin", "openclaw.plugin.json");
-    assert.equal(fs.existsSync(pluginPkgPath), true);
-    assert.equal(fs.existsSync(manifestPath), true);
-    const pluginPkg = readJson(pluginPkgPath);
-    const manifest = readJson(manifestPath);
-    assert.equal(pluginPkg.name, "@haaaiawd/second-nature");
-    assert.equal(pluginPkg.main, "./index.js");
-    assert.ok(pluginPkg.files.includes("index.js"));
-    assert.ok(pluginPkg.files.includes("openclaw.plugin.json"));
-    assert.ok(pluginPkg.files.includes("runtime/"));
-    assert.equal(manifest.id, "second-nature");
-    // OpenClaw 2026.5.x scans `contracts` (not the legacy `capabilities` key) to
-    // expose tools/commands/services. The runtime entry now lives in package.json
-    // `openclaw.runtimeExtensions`, so manifest.entry must NOT be present (it
-    // would mark the manifest as legacy and drop the new fields on the floor).
-    assert.equal(manifest.entry, undefined);
-    assert.equal(manifest.contracts.commands[0], "second-nature");
-    assert.equal(manifest.contracts.tools[0], "second_nature_ops");
-    assert.deepEqual(pluginPkg.openclaw.runtimeExtensions, ["./index.js"]);
-    // CRITICAL — manifest.activation gates whether the gateway daemon's
-    // `loadGatewayStartupPluginPlan` will load this plugin at all. Tool-only
-    // plugins (no channel / no provider / no context-engine slot) MUST opt in
-    // via `activation.onStartup: true`. Without it the plugin appears enabled
-    // in the registry yet never reaches register(api) inside the daemon, which
-    // is exactly the silent-failure mode we hit on 2026-05-06. The
-    // `onCapabilities: ["tool"]` declaration is a second, semantically honest
-    // ticket aligned with discovery-B9FIOZR8.js's onCapabilities allow-list
-    // ("provider" | "channel" | "tool" | "hook"). Do not relax these.
-    const activation = manifest.activation;
-    assert.equal(activation?.onStartup, true, "manifest.activation.onStartup must be true for tool-only plugins");
-    assert.deepEqual(activation?.onCapabilities, ["tool"], "manifest.activation.onCapabilities must declare ['tool']");
-});
-test("T5.3.1 plugin entry declares load/reload lifecycle registration markers", () => {
-    const pluginEntryPath = path.join(root, "plugin", "index.ts");
-    const source = fs.readFileSync(pluginEntryPath, "utf-8");
-    assert.equal(source.includes("second-nature-lifecycle"), true);
-    assert.equal(source.includes("createLifecycleService"), true);
-    assert.equal(source.includes("./runtime/core/second-nature/runtime/"), true);
-    assert.equal(source.includes("createRuntimeService"), true);
-    assert.equal(source.includes("register(api: RegisterApi)"), true);
-    assert.equal(source.includes("async register(api: RegisterApi)"), false);
-    assert.equal(source.includes("recordRuntimeEvidence"), true);
-    assert.equal(source.includes("openclaw/plugin-sdk"), false, "plugin entry must not statically import host SDK during upload/package validation");
-});
-test("T5.3.1 smoke path covers local install and clawhub/npm fallback order", () => {
-    const localPath = runSmoke("local-path");
-    assert.equal(localPath.mode, "local-path");
-    assert.equal(localPath.ok, true);
-    assert.equal(localPath.installSpec.startsWith("file:"), true);
-    assert.equal(localPath.gatewayRestartRequired, true);
-    assert.equal(Object.values(localPath.checks).every(Boolean), true);
-    const clawhub = runSmoke("clawhub");
-    assert.equal(clawhub.mode, "clawhub");
-    assert.equal(clawhub.ok, true);
-    assert.deepEqual(clawhub.fallbackOrder, ["clawhub", "npm"]);
-    const npm = runSmoke("npm");
-    assert.equal(npm.mode, "npm");
-    assert.equal(npm.ok, true);
-    assert.deepEqual(npm.fallbackOrder, ["npm", "file"]);
-});

package/dist/tests/integration/cli/plugin-runtime-registration.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/tests/integration/cli/plugin-runtime-registration.test.js

@@ -1,285 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import path from "node:path";
-import fs from "node:fs";
-import { pathToFileURL } from "node:url";
-async function loadPlugin() {
-    const pluginUrl = pathToFileURL(path.join(process.cwd(), "plugin", "index.js")).href;
-    const mod = await import(pluginUrl);
-    return mod.default;
-}
-test("T5.3.2 plugin register is synchronous and registers surfaces before returning", async () => {
-    const plugin = await loadPlugin();
-    const services = [];
-    const commands = [];
-    const tools = [];
-    const api = {
-        registerService(service) {
-            services.push(service);
-        },
-        registerCommand(command) {
-            commands.push(command);
-        },
-        registerTool(tool) {
-            tools.push(tool);
-        },
-    };
-    const result = plugin.register(api);
-    assert.equal(result, undefined);
-    assert.equal(services.length, 2);
-    assert.equal(commands.length, 1);
-    assert.equal(tools.length, 1);
-    assert.deepEqual(services.map((service) => service.id).sort(), [
-        "second-nature-lifecycle",
-        "second-nature-runtime",
-    ]);
-    assert.equal(commands[0]?.name, "second-nature");
-});
-test("T5.3.2 register does not start services before host invokes them", async () => {
-    const plugin = await loadPlugin();
-    let runtimeService;
-    let lifecycleService;
-    let command;
-    let tool;
-    plugin.register({
-        registerService(service) {
-            if (service.id === "second-nature-runtime") {
-                runtimeService = service;
-            }
-            if (service.id === "second-nature-lifecycle") {
-                lifecycleService = service;
-            }
-        },
-        registerCommand(entry) {
-            command = entry;
-        },
-        registerTool(entry) {
-            tool = entry;
-        },
-    });
-    assert.ok(runtimeService);
-    assert.ok(lifecycleService);
-    assert.ok(command);
-    assert.ok(tool);
-    const lifecycleBeforeUse = lifecycleService.start();
-    assert.equal(lifecycleBeforeUse.registerCount, 0);
-    const commandPayload = JSON.parse((await command.handler({ args: "status" })).text);
-    const toolPayload = JSON.parse((await tool.execute("1", { command: "status" })).content[0]?.text ?? "{}");
-    assert.equal(commandPayload.ok, false);
-    assert.equal(toolPayload.ok, false);
-    assert.equal(commandPayload.data.carrier.serviceStatus, toolPayload.data.carrier.serviceStatus);
-});
-test("T5.3.2 command and tool surfaces share router semantics", async () => {
-    const plugin = await loadPlugin();
-    let command;
-    let tool;
-    plugin.register({
-        registerService() { },
-        registerCommand(entry) {
-            command = entry;
-        },
-        registerTool(entry) {
-            tool = entry;
-        },
-    });
-    assert.ok(command);
-    assert.ok(tool);
-    const commandResult = await command.handler({ args: "status" });
-    const toolResult = await tool.execute("1", { command: "status" });
-    assert.equal(typeof commandResult.text, "string");
-    assert.equal(toolResult.content[0]?.type, "text");
-    const commandPayload = JSON.parse(commandResult.text);
-    const toolPayload = JSON.parse(toolResult.content[0]?.text ?? "{}");
-    assert.equal(commandPayload.ok, false);
-    assert.equal(toolPayload.ok, false);
-    assert.equal(commandPayload.data.carrier.serviceStatus, toolPayload.data.carrier.serviceStatus);
-});
-test("T1.2.3 heartbeat_check is exposed on command/tool surfaces with consumable parity", async () => {
-    const plugin = await loadPlugin();
-    let command;
-    let tool;
-    plugin.register({
-        registerService() { },
-        registerCommand(entry) {
-            command = entry;
-        },
-        registerTool(entry) {
-            tool = entry;
-        },
-    });
-    assert.ok(command);
-    assert.ok(tool);
-    const commandResult = await command.handler({ args: "heartbeat_check 2026-04-27T10:00:00Z host-context" });
-    const toolResult = await tool.execute("1", {
-        command: "heartbeat_check",
-        args: {
-            timestamp: "2026-04-27T10:00:00Z",
-            sessionContext: "host-context",
-            heartbeatChecklist: "call second_nature_ops heartbeat_check",
-        },
-    });
-    const commandPayload = JSON.parse(commandResult.text);
-    const toolPayload = JSON.parse(toolResult.content[0]?.text ?? "{}");
-    assert.equal(commandPayload.ok, true);
-    assert.equal(commandPayload.status, "runtime_carrier_only");
-    assert.equal(commandPayload.surfaceMode, "host_safe_carrier");
-    assert.equal(commandPayload.livedExperienceLoopClaimed, false);
-    assert.equal(commandPayload.nextAction, "continue_carrier_surface_only");
-    assert.equal(commandPayload.data.surface.tool, "second_nature_ops");
-    assert.equal(commandPayload.data.surface.command, "second-nature heartbeat_check");
-    assert.equal(commandPayload.data.bridge.timestamp, "2026-04-27T10:00:00Z");
-    assert.equal(commandPayload.data.bridge.sessionContextProvided, true);
-    assert.equal(commandPayload.data.bridge.heartbeatChecklistProvided, false);
-    assert.equal(commandPayload.data.bridge.serviceEntryMode, "runtime_carrier_only");
-    assert.equal(toolPayload.ok, true);
-    assert.equal(toolPayload.status, "runtime_carrier_only");
-    assert.equal(toolPayload.surfaceMode, "host_safe_carrier");
-    assert.equal(toolPayload.livedExperienceLoopClaimed, false);
-    assert.equal(toolPayload.nextAction, "continue_carrier_surface_only");
-    assert.equal(toolPayload.data.surface.tool, commandPayload.data.surface.tool);
-    assert.equal(toolPayload.data.surface.command, commandPayload.data.surface.command);
-    assert.equal(toolPayload.data.bridge.timestamp, commandPayload.data.bridge.timestamp);
-    assert.equal(toolPayload.data.bridge.sessionContextProvided, commandPayload.data.bridge.sessionContextProvided);
-    assert.equal(toolPayload.data.bridge.heartbeatChecklistProvided, true);
-    assert.equal(toolPayload.data.bridge.serviceEntryMode, commandPayload.data.bridge.serviceEntryMode);
-});
-test("T1.2.3 carrier heartbeat_check honors probeOnly via tool (capability_probe)", async () => {
-    delete process.env.SECOND_NATURE_WORKSPACE_ROOT;
-    const plugin = await loadPlugin();
-    let tool;
-    plugin.register({
-        registerService() { },
-        registerCommand() { },
-        registerTool(entry) {
-            tool = entry;
-        },
-    });
-    assert.ok(tool);
-    const toolResult = await tool.execute("1", {
-        command: "heartbeat_check",
-        args: { probeOnly: true, timestamp: "2026-04-28T10:00:00.000Z" },
-    });
-    const payload = JSON.parse(toolResult.content[0]?.text ?? "{}");
-    assert.equal(payload.ok, true);
-    assert.equal(payload.status, "heartbeat_ok");
-    assert.equal(payload.surfaceMode, "capability_probe");
-    assert.equal(payload.livedExperienceLoopClaimed, false);
-    assert.ok(payload.reasons.includes("probe_only"));
-    assert.equal(payload.data?.bridge?.serviceEntryMode, "capability_probe");
-});
-test("T1.4.3 setup_hint returns packaged SKILL and inner guide", async () => {
-    delete process.env.SECOND_NATURE_WORKSPACE_ROOT;
-    const plugin = await loadPlugin();
-    let tool;
-    plugin.register({
-        registerService() { },
-        registerCommand() { },
-        registerTool(entry) {
-            tool = entry;
-        },
-    });
-    assert.ok(tool);
-    const result = await tool.execute("1", {
-        command: "setup_hint",
-        args: { format: "full" },
-    });
-    const payload = JSON.parse(result.content[0]?.text ?? "{}");
-    assert.equal(payload.ok, true);
-    assert.equal(payload.command, "setup_hint");
-    assert.equal(payload.data?.status, "workspace_root_unknown");
-    assert.equal(payload.data?.skill?.path, "SKILL.md");
-    assert.equal(payload.data?.guide?.path, "agent-inner-guide.md");
-    assert.equal(payload.data?.skill?.content?.includes("Second Nature"), true);
-    assert.equal(payload.data?.guide?.content?.includes("这是一封给 Claw 的便条"), true);
-});
-test("T1.4.3 setup nudge is one-shot and setup_ack persists marker", async () => {
-    delete process.env.SECOND_NATURE_WORKSPACE_ROOT;
-    const plugin = await loadPlugin();
-    let tool;
-    plugin.register({
-        registerService() { },
-        registerCommand() { },
-        registerTool(entry) {
-            tool = entry;
-        },
-    });
-    assert.ok(tool);
-    const workspaceRoot = fs.mkdtempSync(path.join(process.cwd(), "tmp-setup-nudge-"));
-    try {
-        const before = JSON.parse((await tool.execute("1", {
-            command: "credential",
-            args: { action: "verify" },
-            workspaceRoot,
-        })).content[0]?.text ?? "{}");
-        assert.equal(before.setupNudge?.status, "pending");
-        assert.equal(before.setupNudge?.command, "setup_hint");
-        const ack = JSON.parse((await tool.execute("1", {
-            command: "setup_ack",
-            args: {
-                acceptedBy: "agent",
-                placedIn: "workspace/IDENTITY.md",
-            },
-            workspaceRoot,
-        })).content[0]?.text ?? "{}");
-        assert.equal(ack.ok, true);
-        assert.equal(ack.data?.placedIn, "workspace/IDENTITY.md");
-        assert.equal(fs.existsSync(ack.data?.markerPath ?? ""), true);
-        const after = JSON.parse((await tool.execute("1", {
-            command: "credential",
-            args: { action: "verify" },
-            workspaceRoot,
-        })).content[0]?.text ?? "{}");
-        assert.equal(after.setupNudge, undefined);
-    }
-    finally {
-        fs.rmSync(workspaceRoot, { recursive: true, force: true });
-    }
-});
-test("T4.1.4 second_nature_ops storage_smoke uses packaged runtime path", async () => {
-    const plugin = await loadPlugin();
-    let tool;
-    plugin.register({
-        registerService() { },
-        registerCommand() { },
-        registerTool(entry) {
-            tool = entry;
-        },
-    });
-    assert.ok(tool);
-    const basic = JSON.parse((await tool.execute("1", { command: "storage_smoke", args: {} })).content[0]?.text ?? "{}");
-    assert.equal(basic.ok, true);
-    assert.equal(basic.data?.runtimeIndexDriver, "sql_js");
-    assert.equal(basic.data?.semantics?.sqlJs?.walAssumed, false);
-    const repair = JSON.parse((await tool.execute("1", { command: "storage_smoke", args: { runRepairFixture: true } }))
-        .content[0]?.text ?? "{}");
-    assert.equal(repair.ok, true);
-    assert.equal(repair.data?.repairFromArtifactsFixture?.repairStatus, "ok");
-});
-test("T1.2.3 HEARTBEAT.md instructs tool use and carrier vs workspace semantics", () => {
-    const heartbeatPath = path.join(process.cwd(), "HEARTBEAT.md");
-    assert.equal(fs.existsSync(heartbeatPath), true);
-    const source = fs.readFileSync(heartbeatPath, "utf-8");
-    assert.equal(source.includes("second_nature_ops"), true);
-    assert.equal(source.includes("heartbeat_check"), true);
-    assert.equal(source.includes("runtime_carrier_only"), true);
-    assert.equal(source.includes("continue_carrier_surface_only"), true);
-    assert.equal(source.includes("per-heartbeat callback"), true);
-});
-test("T5.3.2 command surface rejects structured-only actions and parses simple args", async () => {
-    const plugin = await loadPlugin();
-    let command;
-    plugin.register({
-        registerService() { },
-        registerCommand(entry) {
-            command = entry;
-        },
-        registerTool() { },
-    });
-    assert.ok(command);
-    const policySet = JSON.parse((await command.handler({ args: "policy set instreet" })).text);
-    assert.equal(policySet.ok, false);
-    assert.equal(policySet.message.includes("structured args"), true);
-    const sessionMissing = JSON.parse((await command.handler({ args: "session" })).text);
-    assert.equal(sessionMissing.ok, false);
-    assert.equal(sessionMissing.error?.code, "MISSING_SESSION_ID");
-});

package/dist/tests/integration/cli/plugin-workspace-ops-bridge.test.d.ts

@@ -1 +0,0 @@
-export {};