import { test, expect } from "vitest";
import {
  buildCommandResultCacheKey,
  parseCommandResultCacheKey,
  COMMAND_RESULT_CACHE_NAMESPACE,
  type CommandResultCacheKey,
} from "../cache/command-result-cache.ts";
import { deriveModuleBasePath } from "../runtime/registry.ts";

/*
<MODULE_CONTRACT>
  <purpose>
    RFC-1028: Test composite cache key format, parse round-trip, and
    deriveModuleBasePath resolution logic.
  </purpose>
<non-goals>
  <item>Not a contract source of truth — the module under test owns the authoritative behavior; fixtures are minimal scaffolding only.</item>
</non-goals>
</MODULE_CONTRACT>
<KEY_DECISIONS>
  <item>Fixtures stay inline and minimal so each case states its own setup.</item>
</KEY_DECISIONS>

<CHANGE_SUMMARY>
  <item>RFC-1028: initial tests for composite cache key and deriveModuleBasePath.</item>
  <item>RFC-1133: cache direct executeKernelCommand executions with flag-keyed results</item>
  <item>RFC-1193: bound module hashing to src/os roots with constant fallbacks</item>
</CHANGE_SUMMARY>
*/
// @ai-invariant fixtures must not couple to internals beyond the public surface under test

test("buildCommandResultCacheKey produces composite string with 6 colon-separated parts", () => {
  const key: CommandResultCacheKey = {
    schemaVersion: 2,
    commandName: "test.check",
    siteName: "my-site",
    inputsHash: "abc123",
    moduleHash: "def456",
    flagsHash: "fff",
  };
  const result = buildCommandResultCacheKey(key);
  expect(result).toBe("2:test.check:my-site:abc123:def456:fff");
});

test("buildCommandResultCacheKey uses empty string for null siteName and empty flagsHash", () => {
  const key: CommandResultCacheKey = {
    schemaVersion: 2,
    commandName: "workspace.check",
    siteName: null,
    inputsHash: "hash1",
    moduleHash: "hash2",
    flagsHash: "",
  };
  const result = buildCommandResultCacheKey(key);
  expect(result).toBe("2:workspace.check::hash1:hash2:");
});

test("parseCommandResultCacheKey round-trips for command_results namespace", () => {
  const composite = "2:test.check:my-site:abc123:def456:fff";
  const parsed = parseCommandResultCacheKey(COMMAND_RESULT_CACHE_NAMESPACE, composite);
  expect(parsed).toEqual({
    commandName: "test.check",
    siteName: "my-site",
    inputsHash: "abc123",
    moduleHash: "def456",
    flagsHash: "fff",
  });
});

test("parseCommandResultCacheKey round-trips algo-prefixed hashes", () => {
  const composite = "2:cmd:site:sha256:aaa:sha256:bbb:sha256:ccc";
  const parsed = parseCommandResultCacheKey(COMMAND_RESULT_CACHE_NAMESPACE, composite);
  expect(parsed).toEqual({
    commandName: "cmd",
    siteName: "site",
    inputsHash: "sha256:aaa",
    moduleHash: "sha256:bbb",
    flagsHash: "sha256:ccc",
  });
});

test("parseCommandResultCacheKey round-trips empty flagsHash", () => {
  const composite = "2:cmd::hash1:hash2:";
  const parsed = parseCommandResultCacheKey(COMMAND_RESULT_CACHE_NAMESPACE, composite);
  expect(parsed).toEqual({
    commandName: "cmd",
    siteName: null,
    inputsHash: "hash1",
    moduleHash: "hash2",
    flagsHash: "",
  });
});

test("parseCommandResultCacheKey rejects v1 keys (schema bump orphans them)", () => {
  const parsed = parseCommandResultCacheKey(
    COMMAND_RESULT_CACHE_NAMESPACE,
    "1:test.check:my-site:abc123:def456",
  );
  expect(parsed).toBeNull();
});

test("parseCommandResultCacheKey returns null for wrong namespace", () => {
  const composite = "2:test.check:my-site:abc123:def456:fff";
  const parsed = parseCommandResultCacheKey("other_namespace", composite);
  expect(parsed).toBeNull();
});

test("parseCommandResultCacheKey returns null for malformed key", () => {
  const parsed = parseCommandResultCacheKey(COMMAND_RESULT_CACHE_NAMESPACE, "too:short");
  expect(parsed).toBeNull();
});

test("deriveModuleBasePath extracts /src path from modulePath", () => {
  expect(deriveModuleBasePath("packages/werkstatt-engine/src/mission/mission.module.ts")).toBe(
    "packages/werkstatt-engine/src",
  );
});

test("deriveModuleBasePath returns undefined when no /src/ or /os/ in path", () => {
  expect(deriveModuleBasePath("packages/forge/kernel/mission.module.ts")).toBeUndefined();
});

test("RFC-1193: deriveModuleBasePath treats /os/ as a module root", () => {
  expect(deriveModuleBasePath("packages/forge/os/mission.module.ts")).toBe("packages/forge/os");
});

test("deriveModuleBasePath handles paths with multiple /src/ segments", () => {
  expect(deriveModuleBasePath("packages/werkstatt-site/src/domain/src/helper.ts")).toBe(
    "packages/werkstatt-site/src",
  );
});