@dreamboard-games/cli 0.1.30-alpha.3 → 0.1.30-alpha.31

package/dist/agent-verifier/chunk-NBRUEJUK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/project/static-scaffold.ts","../../src/release/authoring-release-set.generated.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { readdir, readFile, rmdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { GameTopologyManifest } from \"@dreamboard-games/sdk/types\";\nimport { AUTHORING_RELEASE_SET } from \"../../release/authoring-release-set.js\";\nimport { REDUCER_TESTING_TYPES_WRAPPER_CONTENT } from \"../../templates/testing-types-content.js\";\nimport {\n  MANIFEST_TYPECHECK_CONFIG_FILE,\n  PROJECT_CONFIG_FILE,\n  PROJECT_DIR_NAME,\n} from \"../../constants.js\";\nimport type { LocalMaintainerRegistryConfig } from \"../../types.js\";\nimport { ensureDir } from \"../../utils/fs.js\";\nimport { materializeManifest } from \"./manifest-authoring.js\";\nimport { isDynamicSeedPath } from \"./scaffold-ownership.js\";\nimport {\n  normalizeOwnedProjectPath,\n  readWorkspaceTextFile,\n  readWorkspaceTextFileIfExists,\n  removeWorkspacePath,\n  resolveWorkspacePath,\n  unlinkWorkspaceFile,\n  workspacePathExists,\n  writeWorkspaceTextFile,\n} from \"./workspace-path.js\";\nimport {\n  FRAMEWORK_PNPM_OVERRIDES,\n  FRAMEWORK_REACT_DEPENDENCIES,\n  FRAMEWORK_ZOD_VERSION,\n} from \"./framework-dependencies.js\";\n\ntype StaticScaffoldMode = \"new\" | \"update\";\ntype StaticAssetEntry = {\n  targetPath: string;\n  content: string;\n};\ntype StaticScaffoldOptions = {\n  localMaintainerRegistry?: LocalMaintainerRegistryConfig | null;\n};\ntype RootPackageJsonShape = {\n  private?: boolean;\n  packageManager?: string;\n  scripts?: Record<string, string>;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  optionalDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n  overrides?: Record<string, unknown>;\n  pnpm?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\nconst DREAMBOARD_SCAFFOLD_REFRESH_COMMAND =\n  \"dreamboard project create or dreamboard project clone\";\nconst DREAMBOARD_GITIGNORE_BLOCK = [\n  \"# Dreamboard local state\",\n  \".dreamboard/state.json\",\n  \".dreamboard/snapshot.json\",\n  \".dreamboard/dev/\",\n  \".dreamboard/generated/\",\n  \"node_modules/\",\n  \"ui/node_modules/\",\n  \"\",\n].join(\"\\n\");\nconst TESTING_TYPES_STUB =\n  \"export function defineScenario(scenario) { return scenario; }\\n\";\nconst GENERATED_TESTING_TYPES_PREFIX = \"// Generated by dreamboard\";\nconst GENERATED_SCENARIO_PREFIX = \"// Generated by dreamboard scaffold.\";\nconst LEGACY_DREAMBOARD_COMPONENT_INDEX_CONTENT = `export {\n  ErrorBoundary,\n  type ErrorBoundaryProps,\n} from \"@dreamboard-games/sdk/ui\";\nexport { PluginRuntime, type PluginRuntimeProps } from \"@dreamboard-games/sdk/runtime\";\n`;\nconst OLD_LEGACY_DREAMBOARD_COMPONENT_INDEX_CONTENT = [\n  \"export {\",\n  \"  ErrorBoundary,\",\n  \"  PluginRuntime,\",\n  \"  type ErrorBoundaryProps,\",\n  \"  type PluginRuntimeProps,\",\n  `} from \"@dreamboard/ui-${\"sdk\"}\";`,\n  \"\",\n].join(\"\\n\");\nconst OLD_PUBLIC_DREAMBOARD_COMPONENT_INDEX_CONTENT = [\n  \"export {\",\n  \"  ErrorBoundary,\",\n  \"  PluginRuntime,\",\n  \"  type ErrorBoundaryProps,\",\n  \"  type PluginRuntimeProps,\",\n  `} from \"@dreamboard-games/ui-${\"sdk\"}\";`,\n  \"\",\n].join(\"\\n\");\nconst INITIAL_SCENARIO_CONTENT = `${GENERATED_SCENARIO_PREFIX}\nimport { defineScenario } from \"../testing-types\";\n\nexport default defineScenario({\n  id: \"smoke-initial-turn\",\n  description:\n    \"Sanity check that the scaffolded workspace boots into its initial phase.\",\n  from: \"initial-turn\",\n  when: async () => undefined,\n  then: ({ expect, players, state }) => {\n    const playerIds = players();\n    expect(playerIds).toHaveLength(playerIds.length);\n    expect(playerIds.length).toBeGreaterThanOrEqual(1);\n    expect(state()).toBe(\"setup\");\n  },\n});\n`;\nconst STATIC_ASSET_ROOT = resolveStaticAssetRoot();\nconst SDK_DEPENDENCY_RANGES = {\n  \"@dreamboard-games/sdk\": AUTHORING_RELEASE_SET.packages.sdk.version,\n} as const;\nconst DEV_HOST_DEPENDENCY_RANGES = {\n  \"@dreamboard-games/dev-host\": AUTHORING_RELEASE_SET.packages.devHost.version,\n} as const;\nconst DREAMBOARD_PACKAGE_OVERRIDES = {\n  \"@dreamboard-games/api-client\":\n    AUTHORING_RELEASE_SET.packages.apiClient.version,\n  \"@dreamboard-games/dev-host\": AUTHORING_RELEASE_SET.packages.devHost.version,\n  \"@dreamboard-games/sdk\": AUTHORING_RELEASE_SET.packages.sdk.version,\n} as const;\n\nconst FRAMEWORK_SCRIPTS = {\n  dev: \"dreamboard dev\",\n  \"test:ui\":\n    \"tsx --tsconfig test/tsconfig.tsx-runtime.json --test test/ui/**/*.test.tsx\",\n  typecheck: `tsc --noEmit -p ${MANIFEST_TYPECHECK_CONFIG_FILE} && tsc --noEmit -p app/tsconfig.json && tsc --noEmit -p ui/tsconfig.json`,\n  \"typecheck:manifest\": `tsc --noEmit -p ${MANIFEST_TYPECHECK_CONFIG_FILE}`,\n  \"typecheck:app\": \"tsc --noEmit -p app/tsconfig.json\",\n  \"typecheck:ui\": \"tsc --noEmit -p ui/tsconfig.json\",\n} as const;\nconst SHARED_DEPENDENCIES = {\n  ...FRAMEWORK_REACT_DEPENDENCIES,\n} as const;\nconst ROOT_APP_DEPENDENCIES = {\n  zod: FRAMEWORK_ZOD_VERSION,\n} as const;\nconst SHARED_DEV_DEPENDENCIES = {\n  typescript: \"^5.9.2\",\n  \"@types/node\": \"^24.5.2\",\n  \"@types/react\": \"^19.0.0\",\n  \"@types/react-dom\": \"^19.0.0\",\n  csstype: \"^3.1.3\",\n  tsx: \"^4.20.5\",\n} as const;\n\nexport async function scaffoldStaticWorkspace(\n  projectRoot: string,\n  mode: StaticScaffoldMode,\n  options: StaticScaffoldOptions = {},\n): Promise<void> {\n  await writeFrameworkStaticFiles(projectRoot, mode, options);\n  await ensureDreamboardGitignore(projectRoot);\n  await writeManifestTypecheckTsconfig(projectRoot);\n  await removeLegacyVendoredSdkPaths(projectRoot);\n  await removeLegacyDreamboardComponentPath(projectRoot);\n\n  await ensureDir(resolveWorkspacePath(projectRoot, \"test/bases\"));\n  await ensureDir(resolveWorkspacePath(projectRoot, \"test/scenarios\"));\n  await ensureDir(resolveWorkspacePath(projectRoot, \"test/generated\"));\n\n  await writeTestReadme(projectRoot);\n  await writeGeneratedTestingStubs(projectRoot, mode);\n  const initialTestPlayerCount = await inferInitialTestPlayerCount(projectRoot);\n  await writeInitialBase(projectRoot, mode, initialTestPlayerCount);\n  await writeInitialScenario(projectRoot, mode);\n  await writeTestingTypes(projectRoot, mode);\n  await writeTestTsconfig(projectRoot);\n\n  if (await workspacePathExists(projectRoot, \"test/testing-types.d.ts\")) {\n    await unlinkWorkspaceFile(projectRoot, \"test/testing-types.d.ts\");\n  }\n  if (await workspacePathExists(projectRoot, \"test/base-scenarios.json\")) {\n    await unlinkWorkspaceFile(projectRoot, \"test/base-scenarios.json\");\n  }\n\n  await migrateLegacyScenarioImports(projectRoot);\n}\n\nasync function ensureDreamboardGitignore(projectRoot: string): Promise<void> {\n  const existing = await readWorkspaceTextFileIfExists(\n    projectRoot,\n    \".gitignore\",\n  );\n  if (existing?.includes(\".dreamboard/state.json\")) {\n    return;\n  }\n  await writeWorkspaceTextFile(\n    projectRoot,\n    \".gitignore\",\n    `${existing ? `${existing.trimEnd()}\\n\\n` : \"\"}${DREAMBOARD_GITIGNORE_BLOCK}`,\n  );\n}\n\nexport async function assertCliStaticScaffoldComplete(\n  projectRoot: string,\n  deletedPaths: readonly string[] = [],\n): Promise<void> {\n  const expectedEntries = await getExpectedStaticEntries(projectRoot);\n  const missingOrBlankPaths: string[] = [];\n\n  for (const entry of expectedEntries) {\n    const content = await readWorkspaceTextFileIfExists(\n      projectRoot,\n      entry.targetPath,\n    );\n\n    if (content === null || content.trim().length === 0) {\n      missingOrBlankPaths.push(entry.targetPath);\n    }\n  }\n\n  const staticPaths = new Set(expectedEntries.map((entry) => entry.targetPath));\n  const deletedStaticPaths = deletedPaths\n    .map(normalizeOwnedProjectPath)\n    .filter(\n      (filePath): filePath is string =>\n        filePath !== null && staticPaths.has(filePath),\n    )\n    .sort();\n\n  if (missingOrBlankPaths.length === 0 && deletedStaticPaths.length === 0) {\n    return;\n  }\n\n  const problems: string[] = [];\n  if (missingOrBlankPaths.length > 0) {\n    problems.push(\n      `missing or blank: ${summarizePaths(missingOrBlankPaths.sort())}`,\n    );\n  }\n  if (deletedStaticPaths.length > 0) {\n    problems.push(`deleted: ${summarizePaths(deletedStaticPaths)}`);\n  }\n\n  throw new Error(\n    `CLI static scaffold is incomplete (${problems.join(\"; \")}). Refresh the project scaffold with ${DREAMBOARD_SCAFFOLD_REFRESH_COMMAND} before building or testing.`,\n  );\n}\n\nasync function writeFrameworkStaticFiles(\n  projectRoot: string,\n  mode: StaticScaffoldMode,\n  options: StaticScaffoldOptions,\n): Promise<void> {\n  const assetEntries = await getStaticAssetEntries();\n\n  for (const entry of assetEntries) {\n    // Dynamic seed files are user-customizable: only write them on first\n    // scaffold; preserve existing content on subsequent updates.\n    if (mode === \"update\" && isDynamicSeedPath(entry.targetPath)) {\n      const existing = await readWorkspaceTextFileIfExists(\n        projectRoot,\n        entry.targetPath,\n      );\n      if (existing !== null && existing.trim().length > 0) {\n        continue;\n      }\n    }\n    await writeWorkspaceTextFile(projectRoot, entry.targetPath, entry.content);\n  }\n\n  for (const entry of await getDynamicStaticEntries(\n    projectRoot,\n    mode,\n    options,\n  )) {\n    await writeWorkspaceTextFile(projectRoot, entry.targetPath, entry.content);\n  }\n\n  if (!options.localMaintainerRegistry) {\n    await removeWorkspacePath(projectRoot, \".npmrc\", { force: true });\n  }\n}\n\nasync function removeLegacyVendoredSdkPaths(\n  projectRoot: string,\n): Promise<void> {\n  await removeWorkspacePath(projectRoot, \"app/sdk\", {\n    recursive: true,\n    force: true,\n  });\n  await removeWorkspacePath(projectRoot, \"ui/sdk\", {\n    recursive: true,\n    force: true,\n  });\n}\n\nasync function removeLegacyDreamboardComponentPath(\n  projectRoot: string,\n): Promise<void> {\n  const legacyIndexProjectPath = \"ui/components/dreamboard/index.ts\";\n  const legacyDirPath = resolveWorkspacePath(\n    projectRoot,\n    \"ui/components/dreamboard\",\n  );\n  const existing = await readWorkspaceTextFileIfExists(\n    projectRoot,\n    legacyIndexProjectPath,\n  );\n\n  const removableLegacyContents = new Set([\n    LEGACY_DREAMBOARD_COMPONENT_INDEX_CONTENT.trim(),\n    OLD_LEGACY_DREAMBOARD_COMPONENT_INDEX_CONTENT.trim(),\n    OLD_PUBLIC_DREAMBOARD_COMPONENT_INDEX_CONTENT.trim(),\n  ]);\n\n  if (existing === null || !removableLegacyContents.has(existing.trim())) {\n    return;\n  }\n\n  await unlinkWorkspaceFile(projectRoot, legacyIndexProjectPath);\n  const remainingEntries = await readdir(legacyDirPath).catch(() => []);\n  if (remainingEntries.length === 0) {\n    await rmdir(legacyDirPath);\n  }\n}\n\nasync function writeTestReadme(projectRoot: string): Promise<void> {\n  await writeWorkspaceTextFile(\n    projectRoot,\n    \"test/README.md\",\n    \"# Dreamboard Test Workspace\\n\\nTypeScript bases live in `test/bases/*.base.ts` and scenarios live in `test/scenarios/*.scenario.ts`.\\n\\n1. Define reusable seeded bases with `defineBase({ id, seed, players, setupProfileId?, setup })`.\\n2. Define scenarios with `defineScenario({ id, from, when, then })`.\\n3. Scenario assertions can read `players()`, `state()`, `view(playerId)`, and `interactions(playerId)`.\\n4. Run deterministic scenario tests: `dreamboard test`.\\n5. Run a single scenario when needed: `dreamboard test --scenario <scenario-id>`.\\n\\nImport test helpers from `../testing-types`.\\n\\nGenerated artifacts are written to `test/generated/*` and should not be edited manually.\\n\",\n  );\n}\n\nasync function writeInitialBase(\n  projectRoot: string,\n  mode: StaticScaffoldMode,\n  players: number,\n): Promise<void> {\n  if (mode === \"update\") {\n    return;\n  }\n\n  await writeWorkspaceTextFile(\n    projectRoot,\n    \"test/bases/initial-turn.base.ts\",\n    `import { defineBase } from \"../testing-types\";\n\nexport default defineBase({\n  id: \"initial-turn\",\n  seed: 1337,\n  players: ${players},\n  setup: async () => undefined,\n});\n`,\n  );\n}\n\nasync function writeInitialScenario(\n  projectRoot: string,\n  mode: StaticScaffoldMode,\n): Promise<void> {\n  if (mode === \"new\") {\n    await writeWorkspaceTextFile(\n      projectRoot,\n      \"test/scenarios/smoke-initial-turn.scenario.ts\",\n      INITIAL_SCENARIO_CONTENT,\n    );\n    return;\n  }\n\n  const existing = await readWorkspaceTextFileIfExists(\n    projectRoot,\n    \"test/scenarios/smoke-initial-turn.scenario.ts\",\n  );\n  if (\n    existing === null ||\n    existing.trim().length === 0 ||\n    existing.startsWith(GENERATED_SCENARIO_PREFIX)\n  ) {\n    await writeWorkspaceTextFile(\n      projectRoot,\n      \"test/scenarios/smoke-initial-turn.scenario.ts\",\n      INITIAL_SCENARIO_CONTENT,\n    );\n  }\n}\n\nasync function writeTestingTypes(\n  projectRoot: string,\n  mode: StaticScaffoldMode,\n): Promise<void> {\n  if (mode === \"new\") {\n    await writeWorkspaceTextFile(\n      projectRoot,\n      \"test/testing-types.ts\",\n      REDUCER_TESTING_TYPES_WRAPPER_CONTENT,\n    );\n    return;\n  }\n\n  const existing = await readWorkspaceTextFileIfExists(\n    projectRoot,\n    \"test/testing-types.ts\",\n  );\n  if (shouldRefreshGeneratedTestingTypes(existing)) {\n    await writeWorkspaceTextFile(\n      projectRoot,\n      \"test/testing-types.ts\",\n      REDUCER_TESTING_TYPES_WRAPPER_CONTENT,\n    );\n  }\n}\n\nasync function writeGeneratedTestingStubs(\n  projectRoot: string,\n  mode: StaticScaffoldMode,\n): Promise<void> {\n  const header = \"// Generated by dreamboard scaffold. Do not edit by hand.\\n\";\n  await writeGeneratedTestingStubFile(\n    projectRoot,\n    \"test/generated/base-states.generated.ts\",\n    `${header}export const BASE_STATES = {} as const;\\nexport const BASE_STATES_CONTRACT_FINGERPRINT = undefined;\\n`,\n    mode,\n  );\n  await writeGeneratedTestingStubFile(\n    projectRoot,\n    \"test/generated/base-states.generated.d.ts\",\n    `${header}export declare const BASE_STATES: Record<string, unknown>;\\nexport declare const BASE_STATES_CONTRACT_FINGERPRINT: string | undefined;\\n`,\n    mode,\n  );\n  await writeGeneratedTestingStubFile(\n    projectRoot,\n    \"test/generated/testing-contract.ts\",\n    `${header}export type BaseId = string;\\nexport type GameView = unknown;\\nexport type InteractionId = string;\\nexport type InteractionParamsOf<_Id extends string> = Record<string, unknown>;\\nexport type PhaseName = string;\\nexport type PlayerId = string;\\nexport type RejectionCode = string;\\nexport type StateName = string;\\nexport type ViewByPhase = Record<string, GameView>;\\nexport type WorkspaceStageName<_Phase extends string = string> = string;\\nexport type Expectation = { [matcher: string]: (...args: unknown[]) => unknown; not: Expectation };\\nexport type ExpectFn = (actual: unknown) => Expectation;\\nexport type InteractionExplanation = { interactionId: string; phase: string; step: string | null; availability: \"available\" | \"notYourTurn\" | \"wrongPhase\" | \"wrongStep\" | \"blocked\"; rules: readonly { ruleId: string; outcome: \"passed\" | \"failed\" | \"notEvaluated\"; errorCode?: string; message?: string; }[]; actor: { required: readonly string[]; playerIsActor: boolean }; inputs: readonly { key: string; kind: string; eligibleCount: number | \"lazy\"; }[]; };\\nexport interface InteractionDescriptorFor<Id extends string = string> { interactionId: Id; [key: string]: unknown; }\\nexport interface ScenarioGameApi { start(): Promise<void>; submit<Id extends InteractionId>(playerId: PlayerId, interactionId: Id, params?: InteractionParamsOf<Id>): Promise<void>; }\\nexport interface BaseContext { game: ScenarioGameApi; players(): readonly PlayerId[]; seat(index: number): PlayerId; }\\nexport interface SharedScenarioContext { game: ScenarioGameApi; players(): readonly PlayerId[]; seat(index: number): PlayerId; state(): StateName; view(playerId: PlayerId): GameView; interactions(playerId: PlayerId): readonly InteractionDescriptorFor[]; explain(playerId: PlayerId, interactionId: InteractionId): InteractionExplanation; expect: ExpectFn; }\\nexport type ScenarioContext<Phase extends PhaseName | undefined = undefined> = Omit<SharedScenarioContext, \"state\" | \"view\"> & { state(): Phase extends PhaseName ? Phase : StateName; view(playerId: PlayerId): Phase extends PhaseName ? ViewByPhase[Phase] : GameView; };\\nexport type ScenarioThenContext<Phase extends PhaseName | undefined = undefined> = ScenarioContext<Phase>;\\nexport interface BaseDefinition { id: string; seed?: number; players?: number; setupProfileId?: string; extends?: BaseId | string; setup: (ctx: BaseContext) => void | Promise<void>; }\\nexport interface ScenarioDefinition<Phase extends PhaseName | undefined = undefined> { id: string; description?: string; from: BaseId | string; phase?: Phase; stage?: Phase extends PhaseName ? WorkspaceStageName<Phase> : never; when: (ctx: ScenarioContext<Phase>) => void | Promise<void>; then: (ctx: ScenarioThenContext<Phase>) => void | Promise<void>; }\\n`,\n    mode,\n  );\n  await writeGeneratedTestingStubFile(\n    projectRoot,\n    \"test/generated/scenario-manifest.generated.ts\",\n    `${header}export const SCENARIO_MANIFEST = [] as const;\\n`,\n    mode,\n  );\n}\n\nasync function writeGeneratedTestingStubFile(\n  projectRoot: string,\n  projectPath: string,\n  content: string,\n  mode: StaticScaffoldMode,\n): Promise<void> {\n  if (mode === \"new\") {\n    await writeWorkspaceTextFile(projectRoot, projectPath, content);\n    return;\n  }\n\n  const existing = await readWorkspaceTextFileIfExists(\n    projectRoot,\n    projectPath,\n  );\n  if (\n    existing === null ||\n    existing.trim().length === 0 ||\n    existing.startsWith(GENERATED_SCENARIO_PREFIX)\n  ) {\n    await writeWorkspaceTextFile(projectRoot, projectPath, content);\n  }\n}\n\nasync function writeTestTsconfig(projectRoot: string): Promise<void> {\n  await writeWorkspaceTextFile(\n    projectRoot,\n    \"test/tsconfig.json\",\n    `${JSON.stringify(\n      {\n        compilerOptions: {\n          target: \"ES2022\",\n          module: \"ESNext\",\n          moduleResolution: \"bundler\",\n          strict: true,\n          esModuleInterop: true,\n          skipLibCheck: true,\n          noEmit: true,\n        },\n        include: [\n          \"./**/*.ts\",\n          \"./**/*.d.ts\",\n          \"../shared/**/*.ts\",\n          \"../shared/**/*.d.ts\",\n        ],\n      },\n      null,\n      2,\n    )}\\n`,\n  );\n}\n\nasync function writeManifestTypecheckTsconfig(\n  projectRoot: string,\n): Promise<void> {\n  await writeWorkspaceTextFile(\n    projectRoot,\n    MANIFEST_TYPECHECK_CONFIG_FILE,\n    `${JSON.stringify(\n      {\n        compilerOptions: {\n          target: \"ES2022\",\n          module: \"ESNext\",\n          moduleResolution: \"bundler\",\n          strict: true,\n          esModuleInterop: true,\n          skipLibCheck: true,\n          noEmit: true,\n          allowImportingTsExtensions: true,\n        },\n        include: [\"./manifest.ts\"],\n      },\n      null,\n      2,\n    )}\\n`,\n  );\n}\n\nexport async function migrateLegacyScenarioImports(\n  projectRoot: string,\n): Promise<void> {\n  if (!(await workspacePathExists(projectRoot, \"test/scenarios\"))) return;\n\n  const scenariosRoot = resolveWorkspacePath(projectRoot, \"test/scenarios\");\n  const scenarioFiles = await collectScenarioFiles(scenariosRoot);\n  for (const filePath of scenarioFiles) {\n    const projectPath = toWorkspaceProjectPath(projectRoot, filePath);\n    const content = await readWorkspaceTextFile(projectRoot, projectPath);\n    if (!content.includes(\"@dreamboard/cli/testing\")) continue;\n\n    const relativeToTestingTypes = normalizeImportPath(\n      path.relative(\n        path.dirname(filePath),\n        path.join(projectRoot, \"test\", \"testing-types\"),\n      ),\n    );\n\n    const migrated = content\n      .replaceAll('\"@dreamboard/cli/testing\"', `\"${relativeToTestingTypes}\"`)\n      .replaceAll(\"'@dreamboard/cli/testing'\", `'${relativeToTestingTypes}'`);\n\n    if (migrated !== content) {\n      await writeWorkspaceTextFile(projectRoot, projectPath, migrated);\n    }\n  }\n}\n\nfunction shouldRefreshGeneratedTestingTypes(\n  existingContent: string | null,\n): boolean {\n  if (existingContent === null || existingContent.trim().length === 0) {\n    return true;\n  }\n  if (existingContent === TESTING_TYPES_STUB) {\n    return true;\n  }\n  return existingContent.startsWith(GENERATED_TESTING_TYPES_PREFIX);\n}\n\nasync function inferInitialTestPlayerCount(\n  projectRoot: string,\n): Promise<number> {\n  if (!(await workspacePathExists(projectRoot, \"manifest.ts\"))) {\n    return 4;\n  }\n\n  try {\n    const manifest = await materializeManifest(projectRoot);\n    return manifest.players.optimalPlayers ?? manifest.players.minPlayers ?? 4;\n  } catch {\n    return 4;\n  }\n}\n\nasync function collectScenarioFiles(rootDir: string): Promise<string[]> {\n  const files: string[] = [];\n  const stack = [rootDir];\n\n  while (stack.length > 0) {\n    const dir = stack.pop();\n    if (!dir) continue;\n\n    const entries = await readdir(dir, { withFileTypes: true });\n    for (const entry of entries) {\n      const fullPath = path.join(dir, entry.name);\n      if (entry.isDirectory()) {\n        stack.push(fullPath);\n      } else if (entry.isFile() && entry.name.endsWith(\".ts\")) {\n        files.push(fullPath);\n      }\n    }\n  }\n\n  return files;\n}\n\nexport function resolveStaticAssetRoot(\n  importUrl: string = import.meta.url,\n): string {\n  const candidates = [\n    fileURLToPath(new URL(\"../../scaffold/assets/static/\", importUrl)),\n    fileURLToPath(new URL(\"./scaffold/assets/static/\", importUrl)),\n    fileURLToPath(new URL(\"../scaffold/assets/static/\", importUrl)),\n  ];\n\n  for (const candidate of candidates) {\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n  }\n\n  throw new Error(\n    `Unable to locate CLI static scaffold assets. Checked: ${candidates.join(\", \")}`,\n  );\n}\n\nasync function getStaticAssetEntries(): Promise<StaticAssetEntry[]> {\n  const files = await walkFiles(STATIC_ASSET_ROOT);\n  const entries: StaticAssetEntry[] = [];\n\n  for (const filePath of files) {\n    const targetPath = normalizeOwnedProjectPath(\n      path.relative(STATIC_ASSET_ROOT, filePath).replaceAll(path.sep, \"/\"),\n    );\n    if (targetPath === null) {\n      throw new Error(`Unsafe static scaffold asset path: ${filePath}`);\n    }\n    entries.push({\n      targetPath,\n      content: await readFile(filePath, \"utf8\"),\n    });\n  }\n\n  entries.sort((left, right) =>\n    left.targetPath.localeCompare(right.targetPath),\n  );\n  return entries;\n}\n\nasync function getDynamicStaticEntries(\n  projectRoot: string,\n  mode: StaticScaffoldMode,\n  options: StaticScaffoldOptions = {},\n): Promise<StaticAssetEntry[]> {\n  const entries: StaticAssetEntry[] = [\n    {\n      targetPath: \"package.json\",\n      content: await buildRootPackageJson(projectRoot, mode, options),\n    },\n    {\n      targetPath: \"ui/package.json\",\n      content: buildUiPackageJson(),\n    },\n  ];\n\n  if (options.localMaintainerRegistry) {\n    entries.push({\n      targetPath: \".npmrc\",\n      content: buildWorkspaceNpmrc(options.localMaintainerRegistry.registryUrl),\n    });\n  }\n\n  return entries;\n}\n\nasync function getExpectedStaticEntries(\n  projectRoot: string,\n): Promise<StaticAssetEntry[]> {\n  const entries = [\n    ...(await getStaticAssetEntries()).filter(\n      (entry) => entry.targetPath !== \".npmrc\",\n    ),\n    ...(await getDynamicStaticEntries(projectRoot, \"update\")),\n  ];\n  entries.sort((left, right) =>\n    left.targetPath.localeCompare(right.targetPath),\n  );\n  return entries;\n}\n\nasync function walkFiles(rootDir: string): Promise<string[]> {\n  const files: string[] = [];\n  const stack = [rootDir];\n\n  while (stack.length > 0) {\n    const currentDir = stack.pop();\n    if (!currentDir) continue;\n\n    const entries = await readdir(currentDir, { withFileTypes: true });\n    for (const entry of entries) {\n      const fullPath = path.join(currentDir, entry.name);\n      if (entry.isDirectory()) {\n        stack.push(fullPath);\n      } else if (entry.isFile()) {\n        files.push(fullPath);\n      }\n    }\n  }\n\n  files.sort((left, right) => left.localeCompare(right));\n  return files;\n}\n\nasync function buildRootPackageJson(\n  projectRoot: string,\n  mode: StaticScaffoldMode,\n  options: StaticScaffoldOptions,\n): Promise<string> {\n  const sdkPackageRanges = {\n    ...SDK_DEPENDENCY_RANGES,\n    ...(options.localMaintainerRegistry?.packages ?? {}),\n  };\n  const existingPackageJson =\n    mode === \"update\" &&\n    (await workspacePathExists(projectRoot, \"package.json\"))\n      ? (JSON.parse(\n          await readWorkspaceTextFile(projectRoot, \"package.json\"),\n        ) as RootPackageJsonShape)\n      : null;\n  const {\n    dreamboardFrameworkVersion: _legacyFrameworkVersion,\n    ...existingPackageJsonWithoutLegacyVersion\n  } = existingPackageJson ?? {};\n  const frameworkDependencies = {\n    \"@dreamboard-games/sdk\":\n      sdkPackageRanges[\"@dreamboard-games/sdk\"] ??\n      SDK_DEPENDENCY_RANGES[\"@dreamboard-games/sdk\"],\n    ...SHARED_DEPENDENCIES,\n    ...ROOT_APP_DEPENDENCIES,\n  };\n  const frameworkDevDependencies = {\n    ...SHARED_DEV_DEPENDENCIES,\n    ...DEV_HOST_DEPENDENCY_RANGES,\n  };\n  const nextPackageJson: RootPackageJsonShape = {\n    ...existingPackageJsonWithoutLegacyVersion,\n    private: true,\n    packageManager: AUTHORING_RELEASE_SET.packageManager,\n    scripts: {\n      ...(existingPackageJson?.scripts ?? {}),\n      ...FRAMEWORK_SCRIPTS,\n    },\n    dependencies: {\n      ...(existingPackageJson?.dependencies ?? {}),\n      ...frameworkDependencies,\n    },\n    devDependencies: {\n      ...(existingPackageJson?.devDependencies ?? {}),\n      ...frameworkDevDependencies,\n    },\n    pnpm: mergePnpmConfig(existingPackageJson?.pnpm),\n  };\n  return `${JSON.stringify(nextPackageJson, null, 2)}\\n`;\n}\n\nfunction mergePnpmConfig(\n  existingPnpm: Record<string, unknown> | undefined,\n): Record<string, unknown> {\n  const existingOverrides =\n    existingPnpm?.overrides &&\n    typeof existingPnpm.overrides === \"object\" &&\n    !Array.isArray(existingPnpm.overrides)\n      ? (existingPnpm.overrides as Record<string, unknown>)\n      : {};\n  return {\n    ...(existingPnpm ?? {}),\n    overrides: {\n      ...existingOverrides,\n      ...FRAMEWORK_PNPM_OVERRIDES,\n      ...DREAMBOARD_PACKAGE_OVERRIDES,\n    },\n  };\n}\n\nfunction buildWorkspaceNpmrc(registryUrl: string): string {\n  return `@dreamboard-games:registry=${registryUrl}\\n`;\n}\n\nfunction buildUiPackageJson(): string {\n  return `${JSON.stringify(\n    {\n      private: true,\n      dependencies: SHARED_DEPENDENCIES,\n      devDependencies: SHARED_DEV_DEPENDENCIES,\n    },\n    null,\n    2,\n  )}\\n`;\n}\n\nfunction normalizeImportPath(relativePath: string): string {\n  const normalized = relativePath.replaceAll(\"\\\\\", \"/\");\n  if (normalized.startsWith(\".\")) return normalized;\n  return `./${normalized}`;\n}\n\nfunction toWorkspaceProjectPath(projectRoot: string, filePath: string): string {\n  const relativePath = path\n    .relative(path.resolve(projectRoot), path.resolve(filePath))\n    .replaceAll(path.sep, \"/\");\n  const projectPath = normalizeOwnedProjectPath(relativePath);\n  if (projectPath === null) {\n    throw new Error(`Unsafe project path: ${relativePath}`);\n  }\n  return projectPath;\n}\n\nfunction summarizePaths(paths: readonly string[]): string {\n  const maxShown = 5;\n  const shown = paths.slice(0, maxShown).join(\", \");\n  if (paths.length <= maxShown) return shown;\n  return `${shown}, and ${paths.length - maxShown} more`;\n}\n","// Generated by scripts/generate-authoring-release-set.ts. Do not edit by hand.\nimport type { AuthoringReleaseSetV1 } from \"./authoring-release-set.js\";\n\nexport const AUTHORING_RELEASE_SET = {\n  \"schemaVersion\": 1,\n  \"channel\": \"public\",\n  \"packages\": {\n    \"cli\": {\n      \"name\": \"@dreamboard-games/cli\",\n      \"version\": \"0.1.30-alpha.31\"\n    },\n    \"sdk\": {\n      \"name\": \"@dreamboard-games/sdk\",\n      \"version\": \"0.4.0-alpha.6\"\n    },\n    \"apiClient\": {\n      \"name\": \"@dreamboard-games/api-client\",\n      \"version\": \"0.3.0-alpha.4\"\n    },\n    \"devHost\": {\n      \"name\": \"@dreamboard-games/dev-host\",\n      \"version\": \"0.1.30-alpha.19\"\n    }\n  },\n  \"protocols\": {\n    \"authoringAdapter\": 1,\n    \"devHost\": 1,\n    \"verifier\": 1\n  },\n  \"schemas\": {\n    \"scaffold\": 2,\n    \"manifest\": 2,\n    \"generatedArtifacts\": 1\n  },\n  \"registry\": {\n    \"kind\": \"public-npm\",\n    \"portable\": true\n  },\n  \"packageManager\": \"pnpm@10.4.1\",\n  \"releaseSetId\": \"sha256:d4c979aab04c28c64e3b2f069051eecd00b968ec67fcbe5a7b133ca370e24462\"\n} as const satisfies AuthoringReleaseSetV1;\n"],"mappings":"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","names":[]}

package/dist/agent-verifier/chunk-OJFZVGEL.mjs

@@ -0,0 +1,492 @@
+#!/usr/bin/env node
+
+// src/services/project-authoring/validation.ts
+import path from "path";
+import { createHash } from "crypto";
+
+// src/services/project-authoring/contract.ts
+var ProjectAuthoringError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ProjectAuthoringError";
+    this.code = code;
+  }
+};
+
+// src/services/project-authoring/validation.ts
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isValidGeneratedPath(relativePath) {
+  if (relativePath.length === 0 || relativePath.startsWith("/") || relativePath.includes("\\")) {
+    return false;
+  }
+  const normalized = path.posix.normalize(relativePath);
+  if (normalized !== relativePath) {
+    return false;
+  }
+  return !relativePath.split("/").some((segment) => segment.length === 0 || segment === "." || segment === "..");
+}
+var ALLOWED_GENERATED_PREFIXES = [
+  "app/",
+  "shared/",
+  "test/generated/",
+  "ui/"
+];
+function isAllowedGeneratedPath(relativePath) {
+  return ALLOWED_GENERATED_PREFIXES.some(
+    (prefix) => relativePath.startsWith(prefix)
+  );
+}
+function assertGeneratedPath(pathValue, label) {
+  if (typeof pathValue !== "string" || !isValidGeneratedPath(pathValue) || !isAllowedGeneratedPath(pathValue)) {
+    throw new ProjectAuthoringError(
+      "GENERATED_PATH_CONTRACT_INVALID",
+      `${label} must be a normalized relative workspace path.`
+    );
+  }
+  return pathValue;
+}
+function assertGeneratedArtifact(value) {
+  if (!isRecord(value)) {
+    throw new ProjectAuthoringError(
+      "GENERATED_PATH_CONTRACT_INVALID",
+      "Generated artifact must be an object."
+    );
+  }
+  const artifactPath = assertGeneratedPath(value.path, "Generated artifact path");
+  if (value.ownership !== "authoritative" && value.ownership !== "seed" && value.ownership !== "derived-test") {
+    throw new ProjectAuthoringError(
+      "GENERATED_PATH_CONTRACT_INVALID",
+      `Generated artifact '${artifactPath}' has invalid ownership.`
+    );
+  }
+  if (typeof value.content !== "string") {
+    throw new ProjectAuthoringError(
+      "GENERATED_PATH_CONTRACT_INVALID",
+      `Generated artifact '${artifactPath}' content must be a string.`
+    );
+  }
+  const expectedHash = createHash("sha256").update(value.content).digest("hex");
+  if (value.contentSha256 !== expectedHash) {
+    throw new ProjectAuthoringError(
+      "GENERATED_PATH_CONTRACT_INVALID",
+      `Generated artifact '${artifactPath}' has a stale content hash.`
+    );
+  }
+  return value;
+}
+function validateProjectAuthoringAdapter(adapter) {
+  if (!isRecord(adapter)) {
+    throw new ProjectAuthoringError(
+      "AUTHORING_PROTOCOL_UNSUPPORTED",
+      "SDK authoring export did not provide an adapter object."
+    );
+  }
+  if (adapter.protocolVersion !== 1) {
+    throw new ProjectAuthoringError(
+      "AUTHORING_PROTOCOL_UNSUPPORTED",
+      `Unsupported SDK authoring protocol '${String(adapter.protocolVersion)}'.`
+    );
+  }
+  if (!isRecord(adapter.metadata)) {
+    throw new ProjectAuthoringError(
+      "AUTHORING_PROTOCOL_UNSUPPORTED",
+      "SDK authoring adapter metadata is missing."
+    );
+  }
+  for (const key of [
+    "sdkVersion",
+    "codegenVersion",
+    "manifestSchemaVersion",
+    "generatedArtifactSchemaVersion"
+  ]) {
+    if (adapter.metadata[key] === void 0 || key.endsWith("Version") && typeof adapter.metadata[key] !== "string" && typeof adapter.metadata[key] !== "number") {
+      throw new ProjectAuthoringError(
+        "AUTHORING_PROTOCOL_UNSUPPORTED",
+        `SDK authoring adapter metadata '${key}' is missing.`
+      );
+    }
+  }
+  for (const method of [
+    "validateManifest",
+    "materializeManifest",
+    "generateWorkspaceArtifacts",
+    "generateTestArtifacts"
+  ]) {
+    if (typeof adapter[method] !== "function") {
+      throw new ProjectAuthoringError(
+        "AUTHORING_PROTOCOL_UNSUPPORTED",
+        `SDK authoring adapter method '${method}' is missing.`
+      );
+    }
+  }
+  if (!Array.isArray(adapter.generatedPaths)) {
+    throw new ProjectAuthoringError(
+      "GENERATED_PATH_CONTRACT_INVALID",
+      "SDK authoring adapter generatedPaths must be an array."
+    );
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const [index, generatedPath] of adapter.generatedPaths.entries()) {
+    const normalized = assertGeneratedPath(
+      generatedPath,
+      `generatedPaths[${index}]`
+    );
+    if (seen.has(normalized)) {
+      throw new ProjectAuthoringError(
+        "GENERATED_PATH_CONTRACT_INVALID",
+        `Generated path '${normalized}' is declared more than once.`
+      );
+    }
+    seen.add(normalized);
+  }
+  if (adapter.generatedPathPatterns !== void 0 && !Array.isArray(adapter.generatedPathPatterns)) {
+    throw new ProjectAuthoringError(
+      "GENERATED_PATH_CONTRACT_INVALID",
+      "SDK authoring adapter generatedPathPatterns must be an array."
+    );
+  }
+  for (const [index, pattern] of (adapter.generatedPathPatterns ?? []).entries()) {
+    if (!isRecord(pattern) || typeof pattern.prefix !== "string" || typeof pattern.suffix !== "string" || !isValidGeneratedPath(`${pattern.prefix}placeholder${pattern.suffix}`) || !isAllowedGeneratedPath(`${pattern.prefix}placeholder${pattern.suffix}`)) {
+      throw new ProjectAuthoringError(
+        "GENERATED_PATH_CONTRACT_INVALID",
+        `generatedPathPatterns[${index}] must describe a normalized allowlisted workspace path.`
+      );
+    }
+  }
+  return adapter;
+}
+function validateGeneratedArtifacts(adapter, artifacts) {
+  const seen = /* @__PURE__ */ new Set();
+  const validated = artifacts.map(assertGeneratedArtifact);
+  for (const artifact of validated) {
+    if (seen.has(artifact.path)) {
+      throw new ProjectAuthoringError(
+        "GENERATED_PATH_CONTRACT_INVALID",
+        `Generated artifact path '${artifact.path}' was emitted more than once.`
+      );
+    }
+    const declared = adapter.generatedPaths.includes(artifact.path) || (adapter.generatedPathPatterns ?? []).some(
+      (pattern) => artifact.path.startsWith(pattern.prefix) && artifact.path.endsWith(pattern.suffix) && artifact.path.length > pattern.prefix.length + pattern.suffix.length
+    );
+    if (!declared) {
+      throw new ProjectAuthoringError(
+        "GENERATED_PATH_CONTRACT_INVALID",
+        `Generated artifact path '${artifact.path}' is not declared by the SDK authoring adapter.`
+      );
+    }
+    seen.add(artifact.path);
+  }
+  return validated;
+}
+
+// src/services/project-authoring/loader.ts
+import { readFile } from "fs/promises";
+import path2 from "path";
+import { createRequire } from "module";
+import { setTimeout as delay } from "timers/promises";
+import { pathToFileURL } from "url";
+var PROJECT_SDK_RESOLUTION_RETRY_DELAYS_MS = [50, 150, 300];
+function problemFromResolveError(error) {
+  if (error instanceof ProjectAuthoringError) {
+    return error;
+  }
+  const code = error?.code === "ERR_PACKAGE_PATH_NOT_EXPORTED" ? "AUTHORING_ADAPTER_NOT_EXPORTED" : "SDK_NOT_INSTALLED";
+  return new ProjectAuthoringError(
+    code,
+    code === "AUTHORING_ADAPTER_NOT_EXPORTED" ? "Installed @dreamboard-games/sdk does not export @dreamboard-games/sdk/authoring." : "Install @dreamboard-games/sdk in this workspace before running authoring commands."
+  );
+}
+function assertResolvedInsidePackage(options) {
+  const packageRoot = path2.resolve(options.packageRoot);
+  const resolvedPath = path2.resolve(options.resolvedPath);
+  const relative = path2.relative(packageRoot, resolvedPath);
+  if (relative.startsWith("..") || path2.isAbsolute(relative)) {
+    throw new ProjectAuthoringError(
+      "AUTHORING_ADAPTER_NOT_EXPORTED",
+      `${options.label} resolved outside the installed @dreamboard-games/sdk package.`
+    );
+  }
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function resolveExportTarget(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (!isRecord2(value)) {
+    return null;
+  }
+  for (const condition of ["import", "default"]) {
+    const resolved = resolveExportTarget(value[condition]);
+    if (resolved) {
+      return resolved;
+    }
+  }
+  return null;
+}
+async function resolveDirectProjectAuthoringAdapter(projectRoot) {
+  const packageRoot = path2.join(
+    projectRoot,
+    "node_modules",
+    "@dreamboard-games",
+    "sdk"
+  );
+  const packageJsonPath = path2.join(packageRoot, "package.json");
+  let packageJson;
+  try {
+    packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
+  } catch {
+    return null;
+  }
+  const authoringExport = isRecord2(packageJson.exports) ? resolveExportTarget(packageJson.exports["./authoring"]) : null;
+  if (!authoringExport) {
+    throw new ProjectAuthoringError(
+      "AUTHORING_ADAPTER_NOT_EXPORTED",
+      "Installed @dreamboard-games/sdk does not export @dreamboard-games/sdk/authoring."
+    );
+  }
+  const adapterPath = path2.resolve(packageRoot, authoringExport);
+  assertResolvedInsidePackage({
+    packageRoot,
+    resolvedPath: adapterPath,
+    label: "@dreamboard-games/sdk/authoring"
+  });
+  return { packageJsonPath, adapterPath };
+}
+async function resolveProjectAuthoringAdapter(projectRoot) {
+  const requireFromProject = createRequire(path2.join(projectRoot, "package.json"));
+  let lastError;
+  for (let attempt = 0; attempt <= PROJECT_SDK_RESOLUTION_RETRY_DELAYS_MS.length; attempt += 1) {
+    try {
+      const packageJsonPath = requireFromProject.resolve(
+        "@dreamboard-games/sdk/package.json"
+      );
+      const adapterPath = requireFromProject.resolve(
+        "@dreamboard-games/sdk/authoring"
+      );
+      return { packageJsonPath, adapterPath };
+    } catch (error) {
+      lastError = error;
+      if (error?.code === "ERR_PACKAGE_PATH_NOT_EXPORTED") {
+        throw error;
+      }
+      const directResolved = await resolveDirectProjectAuthoringAdapter(projectRoot);
+      if (directResolved) {
+        return directResolved;
+      }
+      const retryDelay = PROJECT_SDK_RESOLUTION_RETRY_DELAYS_MS[attempt];
+      if (retryDelay === void 0) {
+        break;
+      }
+      await delay(retryDelay);
+    }
+  }
+  throw lastError;
+}
+async function loadProjectAuthoringAdapter(projectRoot) {
+  let packageJsonPath;
+  let adapterPath;
+  try {
+    ({ packageJsonPath, adapterPath } = await resolveProjectAuthoringAdapter(projectRoot));
+  } catch (error) {
+    throw problemFromResolveError(error);
+  }
+  const packageRoot = path2.dirname(packageJsonPath);
+  assertResolvedInsidePackage({
+    packageRoot,
+    resolvedPath: adapterPath,
+    label: "@dreamboard-games/sdk/authoring"
+  });
+  const packageJson = JSON.parse(
+    await readFile(packageJsonPath, "utf8")
+  );
+  if (packageJson.name !== "@dreamboard-games/sdk" || typeof packageJson.version !== "string" || packageJson.version.trim().length === 0) {
+    throw new ProjectAuthoringError(
+      "SDK_METADATA_MISMATCH",
+      "Installed SDK package metadata is invalid."
+    );
+  }
+  const moduleRecord = await import(pathToFileURL(adapterPath).href);
+  const adapter = validateProjectAuthoringAdapter(
+    moduleRecord.projectAuthoringAdapter ?? moduleRecord.default
+  );
+  if (adapter.metadata.sdkVersion !== packageJson.version) {
+    throw new ProjectAuthoringError(
+      "SDK_METADATA_MISMATCH",
+      `SDK authoring adapter reports version ${adapter.metadata.sdkVersion}, but package metadata is ${packageJson.version}.`
+    );
+  }
+  return {
+    packageRoot,
+    packageVersion: packageJson.version,
+    adapterPath,
+    adapter
+  };
+}
+
+// src/services/project/workspace-path.ts
+import {
+  mkdir,
+  readFile as readFile2,
+  realpath,
+  rm,
+  stat,
+  unlink,
+  writeFile
+} from "fs/promises";
+import path3 from "path";
+var CONTROL_CHARS = /[\x00-\x1f\x7f]/;
+var URL_SCHEME = /^[A-Za-z][A-Za-z0-9+.-]*:/;
+var WINDOWS_DEVICE_NAME = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;
+var ENCODED_SEPARATOR = /%(?:2f|5c)/i;
+function isWindowsDeviceSegment(segment) {
+  return WINDOWS_DEVICE_NAME.test(segment.replace(/[. ]+$/g, ""));
+}
+function isPathInside(parent, candidate) {
+  const relative = path3.relative(parent, candidate);
+  return relative === "" || !relative.startsWith("..") && !path3.isAbsolute(relative);
+}
+function assertContained(parent, candidate, label) {
+  if (!isPathInside(parent, candidate)) {
+    throw new Error(`${label} escapes the workspace.`);
+  }
+}
+function isMissingFileError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function normalizeOwnedProjectPath(input) {
+  if (input.length === 0 || input.trim().length === 0 || input.startsWith("/") || input.includes("\\") || input.includes(":") || URL_SCHEME.test(input) || CONTROL_CHARS.test(input) || ENCODED_SEPARATOR.test(input) || path3.win32.isAbsolute(input)) {
+    return null;
+  }
+  const segments = input.split("/");
+  if (segments.some(
+    (segment) => segment.length === 0 || segment.trim().length === 0 || segment === "." || segment === ".." || isWindowsDeviceSegment(segment)
+  )) {
+    return null;
+  }
+  return segments.join("/");
+}
+function resolveWorkspacePath(rootDir, projectPath) {
+  const normalized = normalizeOwnedProjectPath(projectPath);
+  if (normalized === null) {
+    throw new Error(`Unsafe project path: ${projectPath}`);
+  }
+  const rootPath = path3.resolve(rootDir);
+  const resolvedPath = path3.resolve(rootPath, normalized);
+  assertContained(rootPath, resolvedPath, `Project path ${projectPath}`);
+  return resolvedPath;
+}
+async function realpathIfExists(filePath) {
+  try {
+    return await realpath(filePath);
+  } catch (error) {
+    if (isMissingFileError(error)) return null;
+    throw error;
+  }
+}
+async function nearestExistingAncestor(filePath) {
+  let current = filePath;
+  while (true) {
+    try {
+      await stat(current);
+      return current;
+    } catch (error) {
+      if (!isMissingFileError(error)) throw error;
+      const parent = path3.dirname(current);
+      if (parent === current) throw error;
+      current = parent;
+    }
+  }
+}
+async function assertRealpathContained(rootDir, filePath, label) {
+  const rootRealpath = await realpath(rootDir);
+  const targetRealpath = await realpath(filePath);
+  assertContained(rootRealpath, targetRealpath, label);
+}
+async function assertNearestParentContained(rootDir, filePath, label) {
+  const rootRealpath = await realpath(rootDir);
+  const nearestParent = await nearestExistingAncestor(path3.dirname(filePath));
+  const nearestParentRealpath = await realpath(nearestParent);
+  assertContained(rootRealpath, nearestParentRealpath, label);
+}
+async function assertExistingTargetContained(rootDir, filePath, label) {
+  const targetRealpath = await realpathIfExists(filePath);
+  if (targetRealpath === null) return;
+  const rootRealpath = await realpath(rootDir);
+  assertContained(rootRealpath, targetRealpath, label);
+}
+async function prepareWorkspaceWriteTarget(rootDir, filePath) {
+  await assertNearestParentContained(rootDir, filePath, "Project path");
+  await mkdir(path3.dirname(filePath), { recursive: true });
+  await assertRealpathContained(
+    rootDir,
+    path3.dirname(filePath),
+    "Project path"
+  );
+  await assertExistingTargetContained(rootDir, filePath, "Project path");
+}
+async function readWorkspaceTextFile(rootDir, projectPath) {
+  const filePath = resolveWorkspacePath(rootDir, projectPath);
+  await assertExistingTargetContained(rootDir, filePath, "Project path");
+  return readFile2(filePath, "utf8");
+}
+async function readWorkspaceTextFileIfExists(rootDir, projectPath) {
+  const filePath = resolveWorkspacePath(rootDir, projectPath);
+  const targetRealpath = await realpathIfExists(filePath);
+  if (targetRealpath === null) return null;
+  const rootRealpath = await realpath(rootDir);
+  assertContained(rootRealpath, targetRealpath, "Project path");
+  return readFile2(filePath, "utf8");
+}
+async function writeWorkspaceTextFile(rootDir, projectPath, content) {
+  const filePath = resolveWorkspacePath(rootDir, projectPath);
+  await prepareWorkspaceWriteTarget(rootDir, filePath);
+  await writeFile(filePath, content, "utf8");
+}
+async function writeWorkspaceJsonFile(rootDir, projectPath, data) {
+  await writeWorkspaceTextFile(
+    rootDir,
+    projectPath,
+    `${JSON.stringify(data, null, 2)}
+`
+  );
+}
+async function workspacePathExists(rootDir, projectPath) {
+  const filePath = resolveWorkspacePath(rootDir, projectPath);
+  const targetRealpath = await realpathIfExists(filePath);
+  if (targetRealpath === null) return false;
+  const rootRealpath = await realpath(rootDir);
+  assertContained(rootRealpath, targetRealpath, "Project path");
+  return true;
+}
+async function unlinkWorkspaceFile(rootDir, projectPath) {
+  const filePath = resolveWorkspacePath(rootDir, projectPath);
+  await assertNearestParentContained(rootDir, filePath, "Project path");
+  await assertExistingTargetContained(rootDir, filePath, "Project path");
+  await unlink(filePath);
+}
+async function removeWorkspacePath(rootDir, projectPath, options = {}) {
+  const filePath = resolveWorkspacePath(rootDir, projectPath);
+  await assertNearestParentContained(rootDir, filePath, "Project path");
+  await assertExistingTargetContained(rootDir, filePath, "Project path");
+  await rm(filePath, options);
+}
+
+export {
+  validateGeneratedArtifacts,
+  loadProjectAuthoringAdapter,
+  normalizeOwnedProjectPath,
+  resolveWorkspacePath,
+  readWorkspaceTextFile,
+  readWorkspaceTextFileIfExists,
+  writeWorkspaceTextFile,
+  writeWorkspaceJsonFile,
+  workspacePathExists,
+  unlinkWorkspaceFile,
+  removeWorkspacePath
+};
+//# sourceMappingURL=chunk-OJFZVGEL.mjs.map