chore(release): v0.3.2

Export AdfLockfile and AdfSyncStatus types from @stackbilt/adf public
API. Document .adf.lock schema in README. Add tsconfig.build.json,
dev watch script, publishConfig.access on all packages, sideEffects
false on all packages. Simplify publish workflow.

Author: stackbilt-admin

CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project are documented in this file.
 
 The format is based on Keep a Changelog and follows Semantic Versioning.
 
+## [0.3.2] - 2026-02-26
+
+### Added
+- **Lockfile types exported**: `AdfLockfile` and `AdfSyncStatus` interfaces now exported from `@stackbilt/adf` public API, giving agents `.d.ts` visibility into the `.adf.lock` schema without reverse-engineering compiled output.
+- **Lockfile schema documented**: `.adf.lock` format (flat JSON map of `filename → sha256-prefix-16`) documented in the `@stackbilt/adf` README.
+- **`pnpm run dev` watch script**: New `tsc --build --watch` dev script for incremental rebuilds during local development via `tsconfig.build.json`.
+- **Research papers directory**: `papers/` with versioned white papers (CSA-001: Context-as-Code v1.1, CSA-002: Greenfield measurement rubric draft) and Architect v2 integration brief.
+
+### Changed
+- **Build uses `tsconfig.build.json`**: Root build script replaced hardcoded 9-path `tsc --build` invocation with a `tsconfig.build.json` reference file. TypeScript resolves build order from project references automatically.
+- **Publish workflow simplified**: PUBLISHING.md no longer instructs manual `workspace:^` replacement — PNPM handles this at publish time. Publish commands no longer need `--access public` flag.
+- **`publishConfig.access: "public"`** declared in all 9 packages (previously only cli and adf).
+- **`sideEffects: false`** declared in all 9 packages for bundler tree-shaking.
+
 ## [0.3.1] - 2026-02-25
 
 ### Added
@@ -249,6 +263,7 @@ The format is based on Keep a Changelog and follows Semantic Versioning.
 ### Security
 - Added repository security policy and reporting process.
 
+[0.3.2]: https://github.com/stackbilt-dev/charter-kit/compare/v0.3.1...v0.3.2
 [0.3.1]: https://github.com/stackbilt-dev/charter-kit/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/stackbilt-dev/charter-kit/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/stackbilt-dev/charter-kit/compare/v0.1.20...v0.2.0

packages/adf/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackbilt/adf",
   "sideEffects": false,
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "ADF (Attention-Directed Format) — AST-backed context format for AI agents",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

packages/adf/src/types.ts

@@ -203,6 +203,25 @@ export interface BundleResult {
   advisoryOnlyModules: string[];
 }
 
+// ============================================================================
+// Sync / Lockfile Types
+// ============================================================================
+
+/**
+ * .adf.lock file format: flat JSON map of source filename → sha256 prefix (16 hex chars).
+ * Generated by `charter adf sync --write`, checked by `charter adf sync --check`.
+ */
+export interface AdfLockfile {
+  [sourceFile: string]: string;
+}
+
+export interface AdfSyncStatus {
+  source: string;
+  sourceHash: string;
+  lockedHash: string | null;
+  inSync: boolean;
+}
+
 // ============================================================================
 // Constraint Validation
 // ============================================================================

packages/ci/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackbilt/ci",
   "sideEffects": false,
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "GitHub Actions adapter for Charter governance checks",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

packages/classify/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackbilt/classify",
   "sideEffects": false,
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Heuristic change classification (SURFACE/LOCAL/CROSS_CUTTING)",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

packages/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackbilt/cli",
   "sideEffects": false,
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Charter CLI \u2014 repo-level governance checks",
   "bin": {
     "charter": "./dist/bin.js"

packages/core/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackbilt/core",
   "sideEffects": false,
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Core schemas, sanitization, and error handling for Charter Kit",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

packages/drift/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackbilt/drift",
   "sideEffects": false,
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Drift scanner \u2014 detects codebase divergence from governance patterns",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

packages/git/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackbilt/git",
   "sideEffects": false,
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Git trailer parsing, commit risk scoring, and PR validation",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

packages/types/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackbilt/types",
   "sideEffects": false,
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Shared type definitions for the Charter Kit",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",