dreamteamer 0.13.4 → 0.15.0

package/collections/collections.collection.yaml

@@ -40,9 +40,17 @@ schema:
           description: Folder holding the records, workspace-relative. `data/` for content, `state/` for operational records, `system/` for sources.
         codec:
           type: string
-          enum: [md, yaml, json]
+          enum: [md, yaml, json, file]
           default: md
-          description: File format. Use `md` whenever the record has a body a human will read.
+          description: 'File format. Use `md` whenever the record has a body a human will read. `file` makes the record an OPAQUE file — any extension, no frontmatter, fields DERIVED (`ext`, `bytes`), written with `add --from <path>` and never with `set`. For icons, logos and images.'
+        max_bytes:
+          type: integer
+          default: 204800
+          description: '`codec: file` only — the largest a record may be, in bytes. `check` reports anything over it. A record is a small file; a big one belongs outside the vault.'
+        extensions:
+          type: array
+          items: { type: string }
+          description: '`codec: file` only — the extensions this collection accepts, lowercase and without the dot. Omitted means any.'
         shape:
           type: string
           enum: [file, folder]

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dreamteamer",
-	"version": "0.13.4",
+	"version": "0.15.0",
 	"description": "A workspace compiler for coding agents — schema-validated records as plain files over git, compiled into every harness",
 	"license": "Apache-2.0",
 	"author": "Gilad Khen <giladkhen@gmail.com>",

package/skills/building-dreamteamer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: building-dreamteamer
-description: use when authoring or changing anything in a module's source folders (collections/, skills/, agents/, commands/, command-bindings/, ui-views/, collection-templates/) — a collection or a field, a skill, a command, an agent, a ui-view, or studio component code. Also when deciding WHICH of those a request should become, or when a compile/check error names a source file.
+description: use when authoring or changing anything in a module's source folders (collections/, skills/, agents/, commands/, command-bindings/, ui-views/, collection-templates/) — a collection or a field, a skill, a command, an agent, a ui-view, or studio component code. Also when deciding WHICH of those a request should become, or when a compile/check error names a source file. Also when a request names a new kind of thing to keep.
 ---
 
 # building dreamteamer
@@ -19,7 +19,7 @@ actually wants to happen:
 
 | the ask | write | reference |
 |---|---|---|
-| "the workspace has no home for this kind of thing" / a field is missing | a **collection** | `references/collections.md` |
+| "I want to track / manage / keep X" — a new kind of thing, or a model that no longer fits | a **model proposal first**, then the entities it names — `data-modeling.md` decides, `collections.md` writes | `references/data-modeling.md` |
 | "when you're already doing X, know this" — knowledge a session should find itself | a **skill** | `references/skills.md` |
 | "let me type one word and have you do this" | a **command** | `references/commands.md` |
 | "do this with a fresh context and its own tools" | an **agent** | `references/agents.md` |

package/skills/building-dreamteamer/references/collections.md

@@ -81,23 +81,30 @@ templates: [collection-templates/provenance]   # merged at compile, every time
 
 ## judgment the descriptor can't tell you
 
-- **`id.generate` takes creation-time values only** — `{{ created | date }}--{{ name | slug }}`,
-  never a mutable field (`due`, `status`, and note `created` itself is the moment the record is
-  WRITTEN, so a back-dated import files under the import month; derive from the domain's own date
-  field instead). `id.pattern` must accept everything the template can produce — non-latin titles
-  slug to a deterministic short hash, so `[a-z0-9-]` still holds.
-- **The `x-` keywords carry the domain semantics.** `x-reference` (a target collection, or `"*"` for
-  any) is what lets `check` and `rename` follow a field. `x-body` marks the single field that becomes
-  the md body. `x-inverse` declares a two-way link and makes `check` enforce both directions.
-  `x-title-template` overrides how a VALUE of that field is labelled — rarely needed, because a
-  reference already inherits its TARGET collection's `title_template`; author it there instead, once,
-  rather than on every field pointing at it.
-- **Do not enum a field after the fact.** Enumerating a vocabulary the records already violate makes
-  `check` fail on every pre-existing value. `dt values <collection> <field>` derives the real
-  vocabulary from the data — a filter dropdown gets it for free without locking the set.
-- **`icon` / `group`** are the studio nav's material-symbol icon and folder; ungrouped collections
-  list at the top. `list_fields` is the SEED a module ships, not a competing source of truth — a
-  ui-view's `columns` REPLACES it.
+Modeling judgment — the grain, enums vs vocabularies, relations, forcing fields — lives in
+`references/data-modeling.md`. What is left here is mechanics.
+
+- **`id.pattern` must accept everything `id.generate` can produce** — non-latin titles slug to a
+  deterministic short hash, so `[a-z0-9-]` still holds; a `YYYY/MM/`-prefixed id needs `/` in it.
+- **The `x-` keywords carry the domain semantics.** `x-reference` (a target collection, a LIST of
+  them for a union, or `"*"` for any) is what lets `check` and `rename` follow a field. On input, a
+  single-target field also accepts a bare id (`standup`, not `meetings/standup`) — it is qualified
+  before disk, so the file always carries the fully-qualified form; a union or `"*"` field has no
+  single target to infer from, so it still requires the qualified spelling. `x-body` marks the
+  single field that becomes the md body. `x-inverse` declares a two-way link FROM the owning side:
+  compile GENERATES a `readOnly` mirror field on the target, the store maintains its values in the
+  same write as every change to the owner, and `check` reports one fallen behind as stale
+  (`dreamteamer relations rebuild <target>` repairs it, and `dt relations` lists every pair).
+  Declare it from the other side instead with `x-inverse-of: <owner-collection>.<field>` on a field
+  you author there — either spelling, identical compiled result. `x-unique: true` makes it
+  one-to-one, so the mirror is a scalar; `x-on-delete: restrict` (the default) or `set-null` says
+  what deleting the target does to the records pointing at it. `x-title-template` overrides how a
+  VALUE of that field is labelled — rarely needed, because a reference already inherits its TARGET
+  collection's `title_template`; author it there instead, once, rather than on every field pointing
+  at it (a union field inherits a template only when every member's target collection agrees on one).
+- **`icon` and `order`** are the studio nav's material-symbol icon and its sort position; the nav
+  GROUPS by the owning module, not by the deprecated `group`. `list_fields` is the SEED a module
+  ships, not a competing source of truth — a ui-view's `columns` REPLACES it.
 
 ## extending another module's collection
 
@@ -122,10 +129,9 @@ module rather than just for this workspace, fix the base.
 
 1. Sample the files: derive `suffix`/`codec` from the filenames (`<id>.<suffix>.<ext>`) and the id
    `pattern` from the id shapes actually present.
-2. Collect frontmatter keys across files → `properties`; infer types from values. A string field
-   with ≤10 distinct values, repeats and ≥80% fill is probably an `enum` — but see the warning
-   above. Values shaped `<collection>/<id>` are `x-reference` fields. No frontmatter at all →
-   `required: []` with a comment saying why.
+2. Collect frontmatter keys across files → `properties`; infer types from values. Values shaped
+   `<collection>/<id>` are `x-reference` fields. No frontmatter at all → `required: []` with a
+   comment saying why.
 3. **Never edit the records to fit an inferred schema.** Describe reality, compile, run `check`,
    then decide which violations are worth fixing in the data.
 
@@ -141,10 +147,7 @@ ledger.
 
 | mistake | reality |
 |---|---|
-| a mutable field in `id.generate` (`due`, `status`) | ids must never change |
-| `id.generate` from `created` for imported records | `created` is when the record was written, not when the thing happened |
 | tightening `required` before cleaning the data | check floods; widen, rewrite the data, then narrow |
 | a second same-name descriptor without `extends` | compile error by design |
 | a plain string where a ref belongs | use `x-reference` so `check` and `rename` can follow it |
 | a `templates:` ref pointing at another module | that module can no longer be copied or installed alone |
-| inventing a collection for a one-off extraction | a collection is for things that recur; prefer the nearest real one |