The open-source agent harness - the runtime layer that turns an LLM into a working agent.
Document harness optionality and DB timestamp rules.
debajyoti-truefoundry0fc02dabab74
diff --git a/packages/harness/AGENTS.md b/packages/harness/AGENTS.mdnew file mode 100644index 000000000..56c303fe5--- /dev/null+++ b/packages/harness/AGENTS.md@@ -0,0 +1,2 @@+- Top-level public package surfaces (`core`, `agent-session`, and other exported entrypoints) MAY use optional (`?`) properties for caller ergonomics.+- Within this package, records, snapshots, store INPUT types, and other internal contracts MUST NOT use `?`. Absence MUST be an explicit required `| null` or `| undefined` field; prefer `null` for domain absence and `undefined` only when update/patch semantics must distinguish “not provided” from “clear.” Public surfaces adapt by supplying those explicit absences when calling inward. This forces internal object literals to be exhaustive under `tsc`, preventing forgotten fields and silent data loss.diff --git a/packages/harness/CLAUDE.md b/packages/harness/CLAUDE.mdnew file mode 100644index 000000000..43c994c2d--- /dev/null+++ b/packages/harness/CLAUDE.md@@ -0,0 +1 @@diff --git a/packages/server/src/db/AGENTS.md b/packages/server/src/db/AGENTS.mdnew file mode 100644index 000000000..f5ac3e081--- /dev/null+++ b/packages/server/src/db/AGENTS.md@@ -0,0 +1,2 @@+- Temporal columns MUST use `timestamptz` (`timestamp with time zone`). Do not use `timestamp` without time zone.+- Application timestamps MUST be treated as UTC instants. Serialize with `Date.prototype.toISOString()` (always `...Z` with milliseconds).diff --git a/packages/server/src/db/CLAUDE.md b/packages/server/src/db/CLAUDE.mdnew file mode 100644index 000000000..43c994c2d--- /dev/null+++ b/packages/server/src/db/CLAUDE.md@@ -0,0 +1 @@