@fabricorg/databricks-testkit 0.2.4 → 0.4.0

package/README.md

@@ -77,6 +77,37 @@ configured and report `pass | fail | not-configured`; only IDs listed in
 Auto Loader full refreshes require a distinct `DBX_TEST_AUTOLOADER_PIPELINE_ID`.
 The check refuses to use `DBX_TEST_PIPELINE_ID`, protecting production telemetry.
 
+## Typed target packs
+
+Target packs bind a workload adapter, offline unit tests, live checks,
+documentation, certification scope, and Quality Center metadata into one
+versioned contract. Built-in packs cover SQL/Delta, Lakeflow ingestion,
+Jobs/code, Unity Catalog storage, Apps operations, and Lakeflow Jobs
+orchestration.
+
+```ts
+import {
+  builtinTargetPacks,
+  createTargetPackRegistry,
+  doctorTargetPack,
+  runTargetPack,
+} from '@fabricorg/databricks-testkit';
+
+const pack = createTargetPackRegistry(builtinTargetPacks).get('lakeflow-jobs');
+if (!pack) throw new Error('lakeflow-jobs target pack is not installed');
+const diagnosis = doctorTargetPack(pack, process.env);
+if (!diagnosis.ready) throw new Error(diagnosis.missing.join(', '));
+
+const evidence = await runTargetPack(pack, {
+  env: process.env,
+  live: true,
+});
+```
+
+The Lakeflow Jobs adapter models notebook, wheel, JAR, Spark Python, submit,
+pipeline, SQL, dbt, nested-job, condition, and for-each tasks, including graph
+validation, cancellation, repair, and task-level terminal-state assertions.
+
 Docs: `apps/docs/content/docs/testing/` · Plan:
 `.weave/plans/databricks-testing.md` · BDD layer: `@fabricorg/databricks-bdd`
 (Phase 2).