@nanobpm/urban 0.52.0 → 0.53.0

package/src/toolkit/gen.ts

@@ -12,6 +12,7 @@ import { deriveMeta } from "./derivers/meta.ts";
 import { deriveMessageBindings } from "./derivers/messages.ts";
 import { resolveShapes, scanModelShapes } from "./derivers/shapes.ts";
 import { deriveApi } from "./derivers/api.ts";
+import { deriveSystemBrief } from "./derivers/system-brief.ts";
 import { parseSpec, sharedRequestBodySchemas } from "../openapi/spec.ts";
 import { deriveModels, type DerivedModels, type ModelError, MODEL_PROVENANCE } from "./models.ts";
 
@@ -106,31 +107,32 @@ export async function expandPattern(root: string, io: GenIO, pattern: string): P
 }
 
 /** The deploy-by-convention directory (ADR 0062): when the manifest declares no `models`, both the
- *  runtime deploy and this codegen scan discover deployables/models under it — shallow, one level
- *  deep (`resources/*` and `resources/<subdir>/*`). Deploy-only by convention. */
+ *  runtime deploy and this codegen scan discover deployables/models under it — **recursively**,
+ *  every file at any depth (issue #231). Deploy-only by convention. */
 export const RESOURCES_DIR = "resources";
 
 /** Model file extensions the `nano:shape`/code-first scan reads by convention (BPMN + DMN). */
 const MODEL_EXTS = [".bpmn", ".dmn"];
 
 /**
- * Discover model files under `resources/` by convention — shallow, one level deep (`resources/*`
- * and `resources/<subdir>/*`), never deeper — mirroring the runtime deploy walk so the codegen scan
- * and the deploy see the same set. Returns root-relative paths, sorted. Descending one level needs
+ * Discover model files under `resources/` by convention — **recursively**, every `.bpmn`/`.dmn`
+ * under `resources/` at any depth (issue #231) — mirroring the runtime deploy walk so the codegen
+ * scan and the deploy see the same set. Returns root-relative paths, sorted. Descending needs
  * `io.listSubdirs`; without it only the files directly under `resources/` are scanned.
  */
 export async function discoverResourceModels(root: string, io: GenIO): Promise<string[]> {
   const isModel = (n: string): boolean => MODEL_EXTS.some((e) => n.endsWith(e));
   const out: string[] = [];
-  for (const n of await io.listDir(join(root, RESOURCES_DIR))) {
-    if (isModel(n)) out.push(`${RESOURCES_DIR}/${n}`);
-  }
-  const subdirs = io.listSubdirs ? await io.listSubdirs(join(root, RESOURCES_DIR)) : [];
-  for (const sub of subdirs.slice().sort()) {
-    for (const n of await io.listDir(join(root, `${RESOURCES_DIR}/${sub}`))) {
-      if (isModel(n)) out.push(`${RESOURCES_DIR}/${sub}/${n}`);
+  const walk = async (rel: string): Promise<void> => {
+    for (const n of await io.listDir(join(root, rel))) {
+      if (isModel(n)) out.push(`${rel}/${n}`);
     }
-  }
+    const subdirs = io.listSubdirs ? await io.listSubdirs(join(root, rel)) : [];
+    for (const sub of subdirs.slice().sort()) {
+      await walk(`${rel}/${sub}`);
+    }
+  };
+  await walk(RESOURCES_DIR);
   return out.sort();
 }
 
@@ -233,6 +235,11 @@ async function collectAll(opts: GenOptions): Promise<{ artifacts: DerivedArtifac
       artifacts.push(...deriveWorkerBindings(models, declaredTypeIds));
       artifacts.push(...deriveMeta(models));
       artifacts.push(...deriveMessageBindings(models, declaredTypeIds));
+      // Institutional-memory brief (ADR 0060): fold the same scanned model structure into the
+      // app's agent/human-readable system brief. Flows through `artifacts` like its siblings, so
+      // the `nano-generated/` stale sweep and the `urban gen --check` drift gate own the two new
+      // artifacts (system-brief.md / .json) with no extra bookkeeping.
+      artifacts.push(...deriveSystemBrief(models, manifest.id));
       // Surface genuine data-envelope conflicts: a taskType whose variants disagree on a field's
       // TYPE. The emitted contract is the union of the variants (sound for a shared handler), so a
       // type clash would silently widen to `A | B` — warn instead so the author unifies the envelope.

package/src/toolkit/index.ts

@@ -110,6 +110,18 @@ export {
   API_CONTROLLER_TS,
 } from "./derivers/api.ts";
 
+export {
+  buildSystemBrief,
+  deriveSystemBrief,
+  emitSystemBriefMd,
+  foldOwnership,
+  scanModelDecisions,
+  systemBriefDeriver,
+  SYSTEM_BRIEF_JSON,
+  SYSTEM_BRIEF_MD,
+} from "./derivers/system-brief.ts";
+export type { DecisionRef, Ownership, SystemBrief } from "./derivers/system-brief.ts";
+
 // The OpenAPI machinery the deriver + runtime share (ADR 0058).
 export {
   collectOperations,
@@ -139,6 +151,7 @@ import { workerIoDeriver } from "./derivers/worker-io.ts";
 import { metaDeriver } from "./derivers/meta.ts";
 import { messagesDeriver } from "./derivers/messages.ts";
 import { apiDeriver } from "./derivers/api.ts";
+import { systemBriefDeriver } from "./derivers/system-brief.ts";
 export const DERIVERS = [
   migrationsDeriver,
   domainDeriver,
@@ -146,6 +159,7 @@ export const DERIVERS = [
   metaDeriver,
   messagesDeriver,
   apiDeriver,
+  systemBriefDeriver,
 ] as const;
 
 // Gen orchestrator + IO

package/src/toolkit/models.ts

@@ -21,9 +21,10 @@ import { isRecord } from "../runtime/core/guards.ts";
 export const DEFAULT_WORKFLOW_PATTERNS = ["workflows/*.ts"];
 
 /** Default output dir for derived models when the manifest declares no `models.processes`: under
- * the deploy-by-convention `resources/` tree (ADR 0062), one level deep, so a derived model lands
- * exactly where the convention deploy + codegen scan look for it. When `models.processes` IS set,
- * `processesOutDir` derives the dir from that glob instead (the model-first override). */
+ * the deploy-by-convention `resources/` tree (ADR 0062), so a derived model lands where the
+ * convention deploy + codegen scan (which walk `resources/` recursively) look for it. When
+ * `models.processes` IS set, `processesOutDir` derives the dir from that glob instead (the
+ * model-first override). */
 export const PROCESSES_DIR = "resources/processes";
 
 /** Marker stamped into every derived `.bpmn` (an XML comment) so re-gen overwrites and the