Measurement layer M1: Codebook (foundry_codebook, schema helpers, hashing, print, diff)

.Rbuildignore

@@ -7,12 +7,14 @@
 ^docs$
 ^pkgdown$
 ^\.github$
+^\.lintr$
 ^codecov\.yml$
 ^\.Renviron$
 ^\.Renviron\.local$
 ^data-raw$
 ^dev$
 ^PINBOARD\.md$
+^SPEC-measurement-layer\.md$
 ^sessions$
 ^tools$
 ^vignettes/articles$

.gitignore

@@ -24,7 +24,8 @@ Thumbs.db
 docs/
 
 # Test artifacts
-tests/testthat/_snaps/
+tests/testthat/_snaps/*
+!tests/testthat/_snaps/codebook.md
 
 # Environment
 .Renviron

.lintr

@@ -0,0 +1,37 @@
+linters: linters_with_defaults(
+    line_length_linter = line_length_linter(120L),
+    object_usage_linter = NULL,
+    commented_code_linter = NULL
+  )
+exclusions: list(
+    "data-raw/record-doc-outputs.R",
+    "R/agents.R",
+    "R/audio.R",
+    "R/auth.R",
+    "R/batches.R",
+    "R/chat.R",
+    "R/check.R",
+    "R/config.R",
+    "R/content-safety-extra.R",
+    "R/conversations.R",
+    "R/embed-batch.R",
+    "R/embed.R",
+    "R/evals.R",
+    "R/groundedness.R",
+    "R/image.R",
+    "R/moderate.R",
+    "R/responses.R",
+    "R/schema.R",
+    "R/tidymodels.R",
+    "R/token-azure-identity.R",
+    "R/utils.R",
+    "R/vector-stores.R",
+    "tests/manual/test_all_examples.R",
+    "tests/manual/test_contracts_2026_h2.R",
+    "tests/testthat/helper.R",
+    "tests/testthat/test-agents.R",
+    "tests/testthat/test-groundedness.R",
+    "tests/testthat/test-image.R",
+    "vignettes/embeddings.Rmd"
+  )
+encoding: "UTF-8"

DESCRIPTION

@@ -20,6 +20,7 @@ RoxygenNote: 7.3.3
 Imports:
     cli,
     curl,
+    digest,
     dplyr,
     httr2 (>= 1.0.0),
     jsonlite,

NAMESPACE

@@ -1,12 +1,15 @@
 # Generated by roxygen2: do not edit by hand
 
+S3method(format,foundry_codebook)
 S3method(generics::tidy,step_foundry_embed)
+S3method(print,foundry_codebook)
 S3method(print,step_foundry_embed)
 S3method(recipes::bake,step_foundry_embed)
 S3method(recipes::prep,step_foundry_embed)
 S3method(recipes::required_pkgs,step_foundry_embed)
 export("%>%")
 export(as_foundry_schema)
+export(codebook_diff)
 export(foundry_agent)
 export(foundry_agent_create)
 export(foundry_agent_delete)
@@ -35,6 +38,7 @@ export(foundry_blocklists)
 export(foundry_cache_clear)
 export(foundry_chat)
 export(foundry_check_setup)
+export(foundry_codebook)
 export(foundry_consistency)
 export(foundry_conversation_create)
 export(foundry_conversation_delete)
@@ -136,6 +140,10 @@ export(schema_number)
 export(schema_object)
 export(schema_string)
 export(step_foundry_embed)
+export(type_boolean)
+export(type_enum)
+export(type_number)
+export(type_string)
 importFrom(lifecycle,deprecated)
 importFrom(magrittr,"%>%")
 importFrom(rlang,"%||%")

NEWS.md

@@ -9,6 +9,7 @@ Initial development release of foundryR, a tidy interface to Microsoft Azure AI
 - Added cloud evaluation workflows with grader constructors (`foundry_grader_string_check()`, `foundry_grader_text_similarity()`, `foundry_grader_label_model()`, `foundry_grader_score_model()`, and `foundry_grader_azure_ai()` for `builtin.*` evaluators), evaluation and run lifecycle functions (`foundry_eval_create()`, `foundry_evals()`, `foundry_eval_get()`, `foundry_eval_delete()`, `foundry_eval_run_create()`, `foundry_eval_runs()`, `foundry_eval_run_get()`, `foundry_eval_run_cancel()`), and `foundry_eval_run_output_items()`, which returns per-row grader scores as a tibble (roadmap 2026 H2).
 - Added preview Content Safety operations: `foundry_protected_code()` for protected-material-in-code detection, `foundry_moderate_multimodal()` for image-with-text moderation, and `foundry_task_adherence()` (with `foundry_agent_tool()`, `foundry_agent_tool_call()`, and `foundry_agent_message()` builders) for agent task-adherence checks (roadmap 2026 H2).
 - Added Responses API conversation and vector store helpers, including `foundry_conversation_create()`, `foundry_conversations()`, `foundry_vector_store_create()`, `foundry_vector_search()`, and `foundry_tool_file_search()` (roadmap 2026 H2).
+- Added `foundry_codebook()` and `codebook_diff()` for versioned measurement-layer codebooks with deterministic SHA-256 hashes, schema helper wrappers, print output, and codebook diffs (measurement layer M1).
 - Added schema constructors with `foundry_schema()`, `schema_string()`, `schema_enum()`, `schema_number()`, `schema_integer()`, `schema_boolean()`, `schema_array()`, `schema_object()`, and `as_foundry_schema()` for strict structured-output schemas (roadmap 2026 H2).
 - Added validation helpers `foundry_agreement()`, `foundry_consistency()`, and `foundry_provenance()` for publication-oriented annotation checks and reproducibility metadata (roadmap 2026 H2).
 - Added v1 Batch API workflows with `foundry_batch_create()`, `foundry_batches()`, `foundry_batch_get()`, `foundry_batch_cancel()`, and `foundry_batch_requests()` for large-scale prompt, annotation, extraction, and classification jobs.