@aipper/aiws 0.0.29 → 0.0.30

package/src/manifest.js

@@ -1,177 +0,0 @@
-import path from "node:path";
-import { normalizeNewlines, sha256FileText, sha256Text } from "./hash.js";
-import { joinRel, normalizeRel } from "./path-utils.js";
-import { pathExists, readText, writeText } from "./fs.js";
-import { findManagedBlock } from "./managed-blocks.js";
-import { UserError } from "./errors.js";
-
-/**
- * Detect an older AIWS workspace that predates `.aiws/manifest.json`.
- *
- * Current migration only recognizes the built-in `workspace` template.
- *
- * @param {string} workspaceRoot
- * @returns {Promise<string | null>}
- */
-export async function detectLegacyWorkspaceTemplateId(workspaceRoot) {
-  const requiredSignals = [
-    "AI_PROJECT.md",
-    "REQUIREMENTS.md",
-    "AI_WORKSPACE.md",
-    "tools/ws_change_check.py",
-    "tools/requirements_contract.py",
-  ];
-
-  for (const rel of requiredSignals) {
-    const abs = joinRel(workspaceRoot, rel);
-    if (!(await pathExists(abs))) return null;
-  }
-
-  return "workspace";
-}
-
-/**
- * @param {any} manifest
- */
-export function isPlaceholderManifest(manifest) {
-  if (!manifest || typeof manifest !== "object") return true;
-  if (manifest.installed_at === "1970-01-01T00:00:00Z" || manifest.updated_at === "1970-01-01T00:00:00Z") return true;
-
-  const managed = Array.isArray(manifest.managed) ? manifest.managed : [];
-  for (const m of managed) {
-    if (!m || typeof m !== "object") continue;
-    if (typeof m.sha256 === "string" && m.sha256.includes("<sha256>")) return true;
-    if (m.blocks && typeof m.blocks === "object") {
-      for (const v of Object.values(m.blocks)) {
-        if (typeof v === "string" && v.includes("<sha256>")) return true;
-      }
-    }
-  }
-  return false;
-}
-
-/**
- * @param {{ workspaceRoot: string, templateId: string, specVersion: string, aiwsVersion: string, installedAt: string, updatedAt: string, tools: string[], templateManifest: any }} options
- */
-export async function writeWorkspaceManifest(options) {
-  const managed = await computeManagedState({
-    workspaceRoot: options.workspaceRoot,
-    templateManifest: options.templateManifest,
-  });
-
-  const obj = {
-    manifest_version: 1,
-    template_id: options.templateId,
-    spec_version: options.specVersion,
-    aiws_version: options.aiwsVersion,
-    installed_at: options.installedAt,
-    updated_at: options.updatedAt,
-    tools: options.tools,
-    managed,
-  };
-
-  const outPath = path.join(options.workspaceRoot, ".aiws", "manifest.json");
-  await writeText(outPath, JSON.stringify(obj, null, 2) + "\n");
-  return obj;
-}
-
-/**
- * Compute managed hashes for the current workspace.
- *
- * Note: `.aiws/manifest.json` is intentionally excluded from `managed` to avoid self-hashing.
- *
- * @param {{ workspaceRoot: string, templateManifest: any }} options
- */
-export async function computeManagedState(options) {
-  const update = options.templateManifest?.update || {};
-  const replaceFiles = Array.isArray(update.replace_file) ? update.replace_file : [];
-  const managedBlocks = update.managed_blocks && typeof update.managed_blocks === "object" ? update.managed_blocks : {};
-
-  /** @type {any[]} */
-  const out = [];
-
-  for (const relRaw of replaceFiles) {
-    const rel = normalizeRel(relRaw);
-    if (!rel || rel === ".aiws/manifest.json") continue;
-    const abs = joinRel(options.workspaceRoot, rel);
-    if (!(await pathExists(abs))) throw new UserError(`Missing required managed file: ${rel}`);
-    out.push({ path: rel, mode: "replace_file", sha256: await sha256FileText(abs) });
-  }
-
-  for (const [fileRelRaw, blockIdsRaw] of Object.entries(managedBlocks)) {
-    const fileRel = normalizeRel(fileRelRaw);
-    if (!fileRel) continue;
-    const abs = joinRel(options.workspaceRoot, fileRel);
-    if (!(await pathExists(abs))) throw new UserError(`Missing required managed file: ${fileRel}`);
-    const text = normalizeNewlines(await readText(abs));
-    /** @type {Record<string, string>} */
-    const blocks = {};
-    const ids = Array.isArray(blockIdsRaw) ? blockIdsRaw : [];
-    for (const idRaw of ids) {
-      const id = String(idRaw);
-      const found = findManagedBlock(text, id);
-      if (!found) throw new UserError(`Missing managed block: ${id}`, { details: `File: ${fileRel}` });
-      blocks[id] = sha256Text(found.innerText);
-    }
-    out.push({ path: fileRel, mode: "managed_blocks", blocks });
-  }
-
-  out.sort((a, b) => String(a.path).localeCompare(String(b.path)));
-  return out;
-}
-
-/**
- * Validate current workspace against the stored `.aiws/manifest.json` and template contract.
- *
- * @param {{ workspaceRoot: string, storedManifest: any, templateManifest: any }} options
- */
-export async function validateDrift(options) {
-  const stored = options.storedManifest;
-  if (isPlaceholderManifest(stored)) {
-    throw new UserError("Workspace manifest is placeholder/uninitialized.", {
-      details: "Run `aiws init` to generate a real .aiws/manifest.json.",
-    });
-  }
-
-  const expected = await computeManagedState({ workspaceRoot: options.workspaceRoot, templateManifest: options.templateManifest });
-  const currentByPath = new Map(expected.map((e) => [e.path, e]));
-
-  const managed = Array.isArray(stored.managed) ? stored.managed : [];
-  const storedByPath = new Map(managed.map((e) => [String(e.path || ""), e]));
-
-  /** @type {string[]} */
-  const problems = [];
-
-  for (const [p, cur] of currentByPath.entries()) {
-    const s = storedByPath.get(p);
-    if (!s) {
-      problems.push(`missing manifest entry: ${p}`);
-      continue;
-    }
-    if (cur.mode !== s.mode) {
-      problems.push(`mode mismatch: ${p} (expected ${cur.mode}, got ${s.mode})`);
-      continue;
-    }
-    if (cur.mode === "replace_file") {
-      if (cur.sha256 !== s.sha256) {
-        problems.push(`sha256 mismatch: ${p}`);
-      }
-      continue;
-    }
-    if (cur.mode === "managed_blocks") {
-      const curBlocks = cur.blocks || {};
-      const sBlocks = s.blocks || {};
-      for (const [bid, curSha] of Object.entries(curBlocks)) {
-        if (!sBlocks[bid]) {
-          problems.push(`missing block in manifest: ${p} (${bid})`);
-        } else if (sBlocks[bid] !== curSha) {
-          problems.push(`block sha256 mismatch: ${p} (${bid})`);
-        }
-      }
-    }
-  }
-
-  if (problems.length > 0) {
-    throw new UserError("Workspace drift detected.", { details: problems.join("\n") });
-  }
-}

package/src/opencode-env.js

@@ -1,208 +0,0 @@
-import path from "node:path";
-import { pathExists, readText } from "./fs.js";
-
-const OPENCODE_AGENT_NAMES = ["planner-sisyphus", "librarian", "explore", "oracle"];
-const SAFE_READ_ONLY_COMMANDS = new Set(["rg", "cat", "sed", "ls", "find", "git status", "git diff"]);
-const REQUIRED_WRITE_ALLOW_PATHS = [".agentdocs/tmp/", "changes/*/analysis/", "changes/*/review/", "changes/*/evidence/"];
-const REQUIRED_DENY_PATHS = ["secrets/", ".env*"];
-const REQUIRED_DENY_COMMANDS = ["rm", "mv", "git commit", "git push", "npm publish"];
-
-/**
- * @param {string} value
- */
-function relativeOrDot(value) {
-  return value ? value.replaceAll(path.sep, "/") : ".";
-}
-
-/**
- * @param {any} raw
- * @param {string} agentName
- */
-function readAgentState(raw, agentName) {
-  const agents = raw && typeof raw === "object" && raw.agents && typeof raw.agents === "object" ? raw.agents : {};
-  const entry = agents[agentName];
-  return {
-    present: !!entry && typeof entry === "object",
-    enabled: !!(entry && typeof entry === "object" && entry.enabled === true),
-    replacePlan: entry && typeof entry === "object" && typeof entry.replace_plan === "boolean" ? entry.replace_plan : null,
-    promptAppendConfigured: !!(
-      entry &&
-      typeof entry === "object" &&
-      typeof entry.prompt_append === "string" &&
-      entry.prompt_append.trim().length > 0
-    ),
-  };
-}
-
-/**
- * @param {any} raw
- */
-function readApprovalWhitelistState(raw) {
-  const policy =
-    raw &&
-    typeof raw === "object" &&
-    raw.aiws &&
-    typeof raw.aiws === "object" &&
-    raw.aiws.autonomy &&
-    typeof raw.aiws.autonomy === "object" &&
-    raw.aiws.autonomy.approval_whitelist &&
-    typeof raw.aiws.autonomy.approval_whitelist === "object"
-      ? raw.aiws.autonomy.approval_whitelist
-      : null;
-  const readOnlyCommands = Array.isArray(policy?.read_only_commands)
-    ? policy.read_only_commands.filter((value) => typeof value === "string" && value.trim().length > 0)
-    : [];
-  const writeAllowPaths = Array.isArray(policy?.write_allow_paths)
-    ? policy.write_allow_paths.filter((value) => typeof value === "string" && value.trim().length > 0)
-    : [];
-  const denyPaths = Array.isArray(policy?.deny_paths)
-    ? policy.deny_paths.filter((value) => typeof value === "string" && value.trim().length > 0)
-    : [];
-  const denyCommands = Array.isArray(policy?.deny_commands)
-    ? policy.deny_commands.filter((value) => typeof value === "string" && value.trim().length > 0)
-    : [];
-  const mode = typeof policy?.mode === "string" && policy.mode.trim().length > 0 ? policy.mode : "";
-  const hostPermissionMode =
-    typeof policy?.host_permission_mode === "string" && policy.host_permission_mode.trim().length > 0
-      ? policy.host_permission_mode
-      : "";
-  const enabled = policy?.enabled === true;
-  const safeReadOnlyCommands = readOnlyCommands.every((value) => SAFE_READ_ONLY_COMMANDS.has(value));
-  const requiredWritePathsPresent = REQUIRED_WRITE_ALLOW_PATHS.every((value) => writeAllowPaths.includes(value));
-  const requiredDenyPathsPresent = REQUIRED_DENY_PATHS.every((value) => denyPaths.includes(value));
-  const requiredDenyCommandsPresent = REQUIRED_DENY_COMMANDS.every((value) => denyCommands.includes(value));
-  const modeValid = mode === "assist-only";
-
-  return {
-    present: !!policy,
-    enabled,
-    mode,
-    hostPermissionMode,
-    readOnlyCommands,
-    writeAllowPaths,
-    denyPaths,
-    denyCommands,
-    configured:
-      enabled &&
-      modeValid &&
-      safeReadOnlyCommands &&
-      readOnlyCommands.length > 0 &&
-      requiredWritePathsPresent &&
-      requiredDenyPathsPresent &&
-      requiredDenyCommandsPresent &&
-      hostPermissionMode === "manual-only",
-  };
-}
-
-/**
- * @param {string} workspaceRoot
- */
-export async function detectOpenCodeEnvironment(workspaceRoot) {
-  const opencodeDir = path.join(workspaceRoot, ".opencode");
-  const configPath = path.join(opencodeDir, "oh-my-opencode.json");
-  const examplePath = path.join(opencodeDir, "oh-my-opencode.json.example");
-  const opencodeDirExists = await pathExists(opencodeDir);
-  const configExists = await pathExists(configPath);
-  const exampleExists = await pathExists(examplePath);
-
-  /** @type {any} */
-  let config = null;
-  let configStatus = "missing";
-  let configError = "";
-  if (configExists) {
-    try {
-      config = JSON.parse(await readText(configPath));
-      configStatus = "loaded";
-    } catch (error) {
-      configStatus = "invalid";
-      configError = error instanceof Error ? error.message : String(error);
-    }
-  }
-
-  const agents = Object.fromEntries(OPENCODE_AGENT_NAMES.map((name) => [name, readAgentState(config, name)]));
-  const enabledAgents = OPENCODE_AGENT_NAMES.filter((name) => agents[name]?.enabled === true);
-  const recommendedAgentsReady = ["planner-sisyphus", "librarian", "explore", "oracle"].every((name) => agents[name]?.enabled === true);
-  const backgroundTasksConfigured = !!(config && typeof config === "object" && config.backgroundTasks && typeof config.backgroundTasks === "object");
-  const autoResumeEnabled = !!(
-    config &&
-    typeof config === "object" &&
-    config.experimental &&
-    typeof config.experimental === "object" &&
-    config.experimental.auto_resume === true
-  );
-  const approvalWhitelist = readApprovalWhitelistState(config);
-  const claudeSettingsExamplePath = path.join(workspaceRoot, ".claude", "settings.json.example");
-  const approvalWhitelistHelperPath = path.join(opencodeDir, "helpers", "approval-whitelist-check.sh");
-  const approvalWhitelistRunnerPath = path.join(opencodeDir, "helpers", "approval-whitelist-run.sh");
-  const approvalWhitelistWatchdogPath = path.join(opencodeDir, "helpers", "approval-whitelist-watchdog.sh");
-  const tmuxScanHelperPath = path.join(opencodeDir, "helpers", "tmux-swarm-scan.sh");
-  const tmuxRescueHelperPath = path.join(opencodeDir, "helpers", "tmux-swarm-rescue.sh");
-  const claudeSettingsExampleExists = await pathExists(claudeSettingsExamplePath);
-  const approvalWhitelistHelperExists = await pathExists(approvalWhitelistHelperPath);
-  const approvalWhitelistRunnerExists = await pathExists(approvalWhitelistRunnerPath);
-  const approvalWhitelistWatchdogExists = await pathExists(approvalWhitelistWatchdogPath);
-  const tmuxScanHelperExists = await pathExists(tmuxScanHelperPath);
-  const tmuxRescueHelperExists = await pathExists(tmuxRescueHelperPath);
-  const watchdogSuperviseReady =
-    configStatus === "loaded" &&
-    approvalWhitelist.configured &&
-    approvalWhitelistHelperExists &&
-    approvalWhitelistRunnerExists &&
-    approvalWhitelistWatchdogExists;
-  const autonomyReady =
-    configStatus === "loaded" &&
-    agents["planner-sisyphus"]?.promptAppendConfigured === true &&
-    backgroundTasksConfigured &&
-    autoResumeEnabled &&
-    approvalWhitelist.configured &&
-    claudeSettingsExampleExists &&
-    approvalWhitelistHelperExists &&
-    approvalWhitelistRunnerExists &&
-    approvalWhitelistWatchdogExists &&
-    tmuxScanHelperExists &&
-    tmuxRescueHelperExists;
-
-  return {
-    workspaceRoot,
-    opencodeDir,
-    opencodeDirExists,
-    configPath,
-    configExists,
-    configStatus,
-    configError,
-    examplePath,
-    exampleExists,
-    mode: configStatus === "loaded" ? "oMo-enabled" : "standard-opencode",
-    recommendedAgentsReady,
-    enabledAgents,
-    agents,
-    backgroundTasksConfigured,
-    autoResumeEnabled,
-    approvalWhitelist,
-    watchdogSuperviseReady,
-    autonomyReady,
-    claudeSettingsExamplePath,
-    claudeSettingsExampleExists,
-    approvalWhitelistHelperPath,
-    approvalWhitelistHelperExists,
-    approvalWhitelistRunnerPath,
-    approvalWhitelistRunnerExists,
-    approvalWhitelistWatchdogPath,
-    approvalWhitelistWatchdogExists,
-    tmuxScanHelperPath,
-    tmuxScanHelperExists,
-    tmuxRescueHelperPath,
-    tmuxRescueHelperExists,
-    rel: {
-      opencodeDir: relativeOrDot(path.relative(workspaceRoot, opencodeDir)),
-      configPath: relativeOrDot(path.relative(workspaceRoot, configPath)),
-      examplePath: relativeOrDot(path.relative(workspaceRoot, examplePath)),
-      claudeSettingsExamplePath: relativeOrDot(path.relative(workspaceRoot, claudeSettingsExamplePath)),
-      approvalWhitelistHelperPath: relativeOrDot(path.relative(workspaceRoot, approvalWhitelistHelperPath)),
-      approvalWhitelistRunnerPath: relativeOrDot(path.relative(workspaceRoot, approvalWhitelistRunnerPath)),
-      approvalWhitelistWatchdogPath: relativeOrDot(path.relative(workspaceRoot, approvalWhitelistWatchdogPath)),
-      tmuxScanHelperPath: relativeOrDot(path.relative(workspaceRoot, tmuxScanHelperPath)),
-      tmuxRescueHelperPath: relativeOrDot(path.relative(workspaceRoot, tmuxRescueHelperPath)),
-    },
-  };
-}

package/src/path-utils.js

@@ -1,20 +0,0 @@
-import path from "node:path";
-
-/**
- * Join a POSIX-style relative path (with `/`) onto an absolute root.
- *
- * @param {string} rootDir
- * @param {string} relPosix
- */
-export function joinRel(rootDir, relPosix) {
-  return path.join(rootDir, ...String(relPosix).split("/"));
-}
-
-/**
- * Normalize a relative path from manifest (always forward slashes).
- *
- * @param {string} rel
- */
-export function normalizeRel(rel) {
-  return String(rel).replaceAll("\\", "/").replaceAll(/\/+/g, "/").replace(/^\/+/, "");
-}

package/src/spec.js

@@ -1,195 +0,0 @@
-import path from "node:path";
-import fs from "node:fs/promises";
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-import { pathExists, readText } from "./fs.js";
-import { UserError } from "./errors.js";
-import { validateJsonSchemaLite } from "./json-schema-lite.js";
-
-const specJsonDocCache = new Map();
-
-/**
- * @returns {Promise<{ rootDir: string, version: string }>}
- */
-export async function loadSpecPackage() {
-  const require = createRequire(import.meta.url);
-
-  /** @type {string | null} */
-  let pkgJsonPath = null;
-  try {
-    pkgJsonPath = require.resolve("@aipper/aiws-spec/package.json");
-  } catch {
-    pkgJsonPath = null;
-  }
-
-  /** @type {string} */
-  let rootDir;
-  if (pkgJsonPath) {
-    rootDir = path.dirname(pkgJsonPath);
-  } else {
-    const here = fileURLToPath(import.meta.url);
-    rootDir = path.resolve(path.dirname(here), "../../spec");
-    const fallbackPkg = path.join(rootDir, "package.json");
-    if (!(await pathExists(fallbackPkg))) {
-      throw new UserError("Cannot locate @aipper/aiws-spec. Install it or run inside the monorepo.", {
-        exitCode: 1,
-      });
-    }
-  }
-
-  const pkg = JSON.parse(await readText(path.join(rootDir, "package.json")));
-  const version = String(pkg.version || "").trim() || "0.0.0";
-  return { rootDir, version };
-}
-
-/**
- * @param {string} templateId
- */
-export async function loadTemplate(templateId) {
-  if (!templateId || templateId.includes("..") || templateId.includes("/") || templateId.includes("\\")) {
-    throw new UserError(`Invalid template id: ${templateId}`);
-  }
-
-  const spec = await loadSpecPackage();
-  const templateDir = path.join(spec.rootDir, "templates", templateId);
-  const manifestPath = path.join(templateDir, "manifest.json");
-
-  try {
-    await fs.access(manifestPath);
-  } catch {
-    throw new UserError(`Template not found: ${templateId}`, {
-      details: `Missing: ${manifestPath}`,
-    });
-  }
-
-  const manifest = JSON.parse(await readText(manifestPath));
-  return { templateId, templateDir, manifest, specVersion: spec.version };
-}
-
-/**
- * @param {string} relPath
- */
-async function loadSpecJsonDoc(relPath) {
-  const spec = await loadSpecPackage();
-  const absPath = path.join(spec.rootDir, relPath);
-  const cacheKey = `${spec.rootDir}:${relPath}`;
-  if (specJsonDocCache.has(cacheKey)) {
-    return { spec, data: specJsonDocCache.get(cacheKey), absPath };
-  }
-  const raw = await readText(absPath);
-  let data;
-  try {
-    data = JSON.parse(raw);
-  } catch (error) {
-    throw new UserError(`Invalid JSON in spec doc: ${relPath}`, {
-      details: error instanceof Error ? error.message : String(error),
-    });
-  }
-  specJsonDocCache.set(cacheKey, data);
-  return { spec, data, absPath };
-}
-
-async function loadValidatedSpecJsonDoc(relPath, schemaRelPath) {
-  const loaded = await loadSpecJsonDoc(relPath);
-  const { data: schema } = await loadSpecJsonDoc(schemaRelPath);
-  validateJsonSchemaLite(loaded.data, schema, { source: loaded.absPath });
-  return loaded;
-}
-
-export async function loadWorkflowGovernanceRules() {
-  const relPath = path.join("docs", "workflow-governance-rules.json");
-  const schemaRelPath = path.join("docs", "workflow-governance-rules.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  const governanceRules = data.governanceRules;
-  const guidanceRules = data.guidanceRules;
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-governance-rules.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    description: String(data?.description || ""),
-    governanceRules,
-    guidanceRules,
-  };
-}
-
-export async function loadWorkflowStageContracts() {
-  const relPath = path.join("docs", "workflow-stage-contracts.json");
-  const schemaRelPath = path.join("docs", "workflow-stage-contracts.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  const stages = data.stages;
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-stage-contracts.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    description: String(data?.description || ""),
-    standardChain: Array.isArray(data?.standardChain) ? data.standardChain : [],
-    notes: Array.isArray(data?.notes) ? data.notes : [],
-    stages,
-  };
-}
-
-export async function loadWorkflowRouterRules() {
-  const relPath = path.join("docs", "workflow-router-rules.json");
-  const schemaRelPath = path.join("docs", "workflow-router-rules.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-router-rules.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    title: String(data?.title || ""),
-    description: String(data?.description || ""),
-    truthFiles: Array.isArray(data?.truthFiles) ? data.truthFiles : [],
-    bootstrapEntry: data.bootstrapEntry,
-    universalSequence: Array.isArray(data?.universalSequence) ? data.universalSequence : [],
-    routingRules: Array.isArray(data?.routingRules) ? data.routingRules : [],
-    routeCases: Array.isArray(data?.routeCases) ? data.routeCases : [],
-    clarificationTriggers: Array.isArray(data?.clarificationTriggers) ? data.clarificationTriggers : [],
-    universalRules: Array.isArray(data?.universalRules) ? data.universalRules : [],
-    notes: Array.isArray(data?.notes) ? data.notes : [],
-  };
-}
-
-export async function loadWorkflowReviewGates() {
-  const relPath = path.join("docs", "workflow-review-gates.json");
-  const schemaRelPath = path.join("docs", "workflow-review-gates.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-review-gates.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    title: String(data?.title || ""),
-    description: String(data?.description || ""),
-    gates: Array.isArray(data?.gates) ? data.gates : [],
-    unifiedRules: Array.isArray(data?.unifiedRules) ? data.unifiedRules : [],
-    evidence: Array.isArray(data?.evidence) ? data.evidence : [],
-    notes: Array.isArray(data?.notes) ? data.notes : [],
-  };
-}
-
-export async function loadWorkflowDelegationContracts() {
-  const relPath = path.join("docs", "workflow-delegation-contracts.json");
-  const schemaRelPath = path.join("docs", "workflow-delegation-contracts.schema.json");
-  const { spec, data } = await loadValidatedSpecJsonDoc(relPath, schemaRelPath);
-  return {
-    ok: true,
-    source: "@aipper/aiws-spec/docs/workflow-delegation-contracts.json",
-    specVersion: spec.version,
-    version: Number(data?.version || 1),
-    title: String(data?.title || ""),
-    description: String(data?.description || ""),
-    purpose: Array.isArray(data?.purpose) ? data.purpose : [],
-    truthFiles: Array.isArray(data?.truthFiles) ? data.truthFiles : [],
-    delegationFlow: Array.isArray(data?.delegationFlow) ? data.delegationFlow : [],
-    roleTypes: Array.isArray(data?.roleTypes) ? data.roleTypes : [],
-    artifactTargets: Array.isArray(data?.artifactTargets) ? data.artifactTargets : [],
-    reviewConvergence: data?.reviewConvergence || {},
-    fallbackMode: data?.fallbackMode || {},
-    toolCapabilityMatrix: Array.isArray(data?.toolCapabilityMatrix) ? data.toolCapabilityMatrix : [],
-    universalRules: Array.isArray(data?.universalRules) ? data.universalRules : [],
-    notes: Array.isArray(data?.notes) ? data.notes : [],
-  };
-}