@nanobpm/urban 0.56.0 → 0.57.0

package/dist/context/adversarial/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/adversarial/index.js

@@ -0,0 +1 @@
+export {};

package/dist/context/binding/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/binding/index.js

@@ -0,0 +1 @@
+export {};

package/dist/context/conformance/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/conformance/index.js

@@ -0,0 +1 @@
+export {};

package/dist/context/conformance/scaffold.conformance.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/conformance/scaffold.conformance.js

@@ -0,0 +1,10 @@
+// SCAFFOLD PLACEHOLDER — always-passing conformance case so `test:conformance`
+// is GREEN on the empty scaffold. Slice S2 (schema) REPLACES this file with the
+// real conformance corpus/tests under src/context/conformance/**/*.conformance.ts.
+// S2 must NOT edit packages/urban/package.json (the test:conformance script is
+// already pre-declared here by the scaffold).
+import { test } from "node:test";
+import assert from "node:assert/strict";
+test("scaffold conformance placeholder — replaced by slice S2", () => {
+    assert.equal(true, true);
+});

package/dist/context/git/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/git/index.js

@@ -0,0 +1 @@
+export {};

package/dist/context/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./binding/index.ts";
+export * from "./schema/index.ts";
+export * from "./pii/index.ts";
+export * from "./git/index.ts";
+export * from "./retrieval/index.ts";
+export * from "./conformance/index.ts";

package/dist/context/index.js

@@ -0,0 +1,18 @@
+// @nanobpm/urban/context — the Urban context layer (epic #303).
+//
+// This is the SCAFFOLD-OWNED top barrel. It re-exports the public surface of
+// each slice subdirectory so consumers can `import { … } from
+// "@nanobpm/urban/context"`. Every slice owns exactly ONE subdirectory and
+// replaces only its own `index.ts`; nobody but the scaffold task edits this
+// file or packages/urban/package.json. See ./README.md for the seam contract.
+//
+// While the scaffold is empty every subdir barrel is `export {};`, so this
+// aggregate typechecks and builds cleanly. Slice barrels are re-exported here
+// as they land; the adversarial slice (S7) is test-only and is intentionally
+// NOT part of the published surface.
+export * from "./binding/index.js";
+export * from "./schema/index.js";
+export * from "./pii/index.js";
+export * from "./git/index.js";
+export * from "./retrieval/index.js";
+export * from "./conformance/index.js";

package/dist/context/pii/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/pii/index.js

@@ -0,0 +1 @@
+export {};

package/dist/context/retrieval/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/retrieval/index.js

@@ -0,0 +1 @@
+export {};

package/dist/context/schema/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/schema/index.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nanobpm/urban",
-	"version": "0.56.0",
+	"version": "0.57.0",
 	"description": "Urban: build and run code-first apps on Nano — runtime, derivation toolkit, and CLI in one. Author durable processes with @nanobpm/workflow (defineFlow), a typed datasource, forms, triggers and surfaces from a nano.app.json manifest, on Node or Deno.",
 	"license": "Apache-2.0",
 	"type": "module",
@@ -51,6 +51,35 @@
 			"types": "./dist/effect/index.d.ts",
 			"default": "./dist/effect/index.js"
 		},
+		"./context": {
+			"types": "./dist/context/index.d.ts",
+			"default": "./dist/context/index.js"
+		},
+		"./context/binding": {
+			"types": "./dist/context/binding/index.d.ts",
+			"default": "./dist/context/binding/index.js"
+		},
+		"./context/schema": {
+			"types": "./dist/context/schema/index.d.ts",
+			"default": "./dist/context/schema/index.js"
+		},
+		"./context/pii": {
+			"types": "./dist/context/pii/index.d.ts",
+			"default": "./dist/context/pii/index.js"
+		},
+		"./context/git": {
+			"types": "./dist/context/git/index.d.ts",
+			"default": "./dist/context/git/index.js"
+		},
+		"./context/retrieval": {
+			"types": "./dist/context/retrieval/index.d.ts",
+			"default": "./dist/context/retrieval/index.js"
+		},
+		"./context/conformance": {
+			"types": "./dist/context/conformance/index.d.ts",
+			"default": "./dist/context/conformance/index.js"
+		},
+		"./context/source": "./src/context/index.ts",
 		"./source": "./src/index.ts"
 	},
 	"files": [
@@ -65,6 +94,8 @@
 		"gen:runtime": "node scripts/gen-runtime.mjs",
 		"check:runtime": "node scripts/gen-runtime.mjs --check",
 		"test": "node --test --experimental-strip-types \"src/**/*.test.ts\"",
+		"test:conformance": "node --test --experimental-strip-types \"src/context/conformance/**/*.conformance.ts\"",
+		"check:pii": "node --experimental-strip-types scripts/check-pii.ts",
 		"test:deno": "deno test -A --no-check src/"
 	},
 	"dependencies": {

package/src/context/README.md

@@ -0,0 +1,60 @@
+# `@nanobpm/urban/context` — the Urban context layer (epic #303)
+
+This directory is the **producer** side of the Urban context layer: a git-backed,
+governed memory substrate for Nano apps. It is published from `@nanobpm/urban`
+under the `./context/*` subpaths and is the contract that the consumer repo
+(`nanobpm/nano-workforce#291`) builds against.
+
+The layer is delivered as a set of parallel **slices**, each landed by its own
+agent. This README documents the **seam** that lets those slices land in
+parallel without colliding.
+
+## What `@nanobpm/urban/context` publishes
+
+| Subpath                          | Slice           | Surface |
+| -------------------------------- | --------------- | ------- |
+| `@nanobpm/urban/context`         | scaffold barrel | Aggregate of every slice below |
+| `@nanobpm/urban/context/binding` | S1              | Bindable `context` resource + binding descriptor |
+| `@nanobpm/urban/context/schema`  | S2              | Memory-record schema + provenance/mode model |
+| `@nanobpm/urban/context/pii`     | S6              | PII classifier + mandatory pre-commit guard |
+| `@nanobpm/urban/context/git`     | S3              | Git substrate + PR-governance + path partitioning |
+| `@nanobpm/urban/context/retrieval` | S4            | Retrieval (structured / frontmatter / text) |
+| `@nanobpm/urban/context/conformance` | S2          | Conformance corpus + reusable runner (imported by S7 and the consumer) |
+| `@nanobpm/urban/context/source`  | —               | Raw TypeScript entry (mirrors the package's `./source`) |
+
+The adversarial slice (S7) lives in `./adversarial/` and is **test-only** — it is
+not part of the published surface and is intentionally excluded from the top
+barrel.
+
+## The seam — rules every slice MUST follow
+
+1. **Each slice owns exactly one subdirectory.** A slice replaces only files
+   inside its own directory (its placeholder `index.ts` becomes its real
+   barrel). It never edits a sibling's directory.
+
+2. **Only the scaffold task edits the shared surface.** `packages/urban/package.json`
+   (the `exports` map **and** the `scripts` block) and this directory's top
+   barrel `index.ts` are **scaffold-owned**. No sibling slice may edit either —
+   everything a slice needs (its subpath export, and the two shared scripts) is
+   **pre-declared** here already.
+
+3. **Fill the pre-declared subpaths and scripts.** The `exports` map already
+   lists every `./context/*` subpath (including `./context/conformance`), and the
+   `scripts` block already declares:
+   - `test:conformance` → runs `src/context/conformance/**/*.conformance.ts`.
+     **Slice S2 replaces** the placeholder `conformance/scaffold.conformance.ts`
+     with the real corpus/tests. S2 must not touch `package.json`.
+   - `check:pii` → runs `scripts/check-pii.ts`. **Slice s6-pii-ci replaces** the
+     no-op `scripts/check-pii.ts` placeholder with real layout-aware
+     classification. It must not touch `package.json`.
+
+## Build / test wiring
+
+- Context code lives under `src/`, which `tsconfig.build.json` already globs, so
+  the new files build with no compiler-config change.
+- Context code is **server-side only** and is deliberately **not** added to
+  `tsconfig.browser.json`.
+- `npm run test --workspace @nanobpm/urban` runs `src/**/*.test.ts`.
+- `npm run test:conformance --workspace @nanobpm/urban` runs the conformance
+  corpus.
+- `npm run check:pii --workspace @nanobpm/urban` runs the PII gate.

package/src/context/adversarial/index.ts

@@ -0,0 +1,2 @@
+// Slice S7 (adversarial/regression tests) — owner fills this directory.
+export {};

package/src/context/binding/index.ts

@@ -0,0 +1,2 @@
+// Slice S1 (binding) — owner replaces this placeholder barrel.
+export {};

package/src/context/conformance/index.ts

@@ -0,0 +1,2 @@
+// Slice S2 (conformance corpus + fixtures) — owner replaces this placeholder barrel.
+export {};

package/src/context/conformance/scaffold.conformance.ts

@@ -0,0 +1,11 @@
+// SCAFFOLD PLACEHOLDER — always-passing conformance case so `test:conformance`
+// is GREEN on the empty scaffold. Slice S2 (schema) REPLACES this file with the
+// real conformance corpus/tests under src/context/conformance/**/*.conformance.ts.
+// S2 must NOT edit packages/urban/package.json (the test:conformance script is
+// already pre-declared here by the scaffold).
+import { test } from "node:test";
+import assert from "node:assert/strict";
+
+test("scaffold conformance placeholder — replaced by slice S2", () => {
+  assert.equal(true, true);
+});

package/src/context/git/index.ts

@@ -0,0 +1,2 @@
+// Slice S3 (git/governance) — owner replaces this placeholder barrel.
+export {};

package/src/context/index.ts

@@ -0,0 +1,19 @@
+// @nanobpm/urban/context — the Urban context layer (epic #303).
+//
+// This is the SCAFFOLD-OWNED top barrel. It re-exports the public surface of
+// each slice subdirectory so consumers can `import { … } from
+// "@nanobpm/urban/context"`. Every slice owns exactly ONE subdirectory and
+// replaces only its own `index.ts`; nobody but the scaffold task edits this
+// file or packages/urban/package.json. See ./README.md for the seam contract.
+//
+// While the scaffold is empty every subdir barrel is `export {};`, so this
+// aggregate typechecks and builds cleanly. Slice barrels are re-exported here
+// as they land; the adversarial slice (S7) is test-only and is intentionally
+// NOT part of the published surface.
+
+export * from "./binding/index.ts";
+export * from "./schema/index.ts";
+export * from "./pii/index.ts";
+export * from "./git/index.ts";
+export * from "./retrieval/index.ts";
+export * from "./conformance/index.ts";

package/src/context/pii/index.ts

@@ -0,0 +1,2 @@
+// Slice S6 (pii guard-core, then S6 CI) — owner replaces this placeholder barrel.
+export {};

package/src/context/retrieval/index.ts

@@ -0,0 +1,2 @@
+// Slice S4 (retrieval) — owner replaces this placeholder barrel.
+export {};

package/src/context/schema/index.ts

@@ -0,0 +1,2 @@
+// Slice S2 (schema) — owner replaces this placeholder barrel.
+export {};