@wildo-ai/platform-core-shared 1.1.11 → 1.1.13

package/dist/esm/workbench/creation-journey-timeline.custom.shared.schemas.js

@@ -0,0 +1,188 @@
+import { z } from 'zod';
+/**
+ * The creation journey's TIMELINE (#3206, the acceptance of epic #3204): how long each phase of creating an
+ * application took, end to end, and which build tasks took longest — split into the time a task waited to be
+ * dispatched and the time its run took.
+ *
+ * ## Why it exists
+ *
+ * On `app-creation-test-007` creating one application took 3.5 days, and about 75 % of the build's wall clock was a
+ * selected task WAITING for its dispatch (22 to 67 minutes a task, against 5 to 23 for the run). Nothing showed it:
+ * the figures in #3206 were reconstructed by hand from a log line, `wildo build dispatches` rows and commit times.
+ * The timeline is that reconstruction, derived on every read from the rows the companion already keeps — the playbook
+ * runs' executions and each build task's attempts — so the next creation run's figures are one command away.
+ *
+ * ## Where it is derived, and where this contract sits
+ *
+ * The companion derives it (`deriveCreationJourneyTimeline`) and serves it on `GET /api/companion/creation/timeline`;
+ * `wildo context journey` prints it. This file is the shape both read, and the vocabulary both name: the CLI cannot
+ * import the companion, so the enums live here, as the other creation-console contracts do.
+ */
+/**
+ * A PHASE of creating an application: one of the four lanes the creation umbrella (`cross_cutting.application-creation`)
+ * admits. A phase is the work of its lane — the lane's own runs and every run of a playbook its choreography admits,
+ * transitively — not a gate: nothing waits on a phase (`MetaWorkflow_Phase` records why a derived phase was removed as
+ * a gate). The phases overlap in time when the lanes do; each one's span is its own first start to its last settle.
+ */
+export var CreationJourneyPhase;
+(function (CreationJourneyPhase) {
+    /** What the application is: vision, market, requirements, brand, scope (`top_down.definition`). */
+    CreationJourneyPhase["DEFINITION"] = "definition";
+    /** What the application owes: the compliance posture, its programme and its governed documents (`cross_cutting.compliance`). */
+    CreationJourneyPhase["COMPLIANCE"] = "compliance";
+    /** How it is built: the domain plan, the foundation, the surface plans, placement (`bottom_up.conception`). */
+    CreationJourneyPhase["CONCEPTION"] = "conception";
+    /**
+     * Building it: the build plan's decomposition and every task's dispatch (`bottom_up.build`). Its span also covers
+     * every build-task attempt, whoever started it: a single-task `wildo build run --single`, a workbench dispatch and a
+     * named run start no playbook of the build lane, and their runs are still the build.
+     */
+    CreationJourneyPhase["BUILD"] = "build";
+})(CreationJourneyPhase || (CreationJourneyPhase = {}));
+/**
+ * The lane composite each phase is the work of: the four lanes `cross_cutting.application-creation` admits. It also
+ * admits the vision interview, a leaf (#3386); that stays DEFINITION work because the definition lane admits it too.
+ */
+export const CREATION_JOURNEY_PHASE_LANE_REFS = {
+    [CreationJourneyPhase.DEFINITION]: 'top_down.definition',
+    [CreationJourneyPhase.COMPLIANCE]: 'cross_cutting.compliance',
+    [CreationJourneyPhase.CONCEPTION]: 'bottom_up.conception',
+    [CreationJourneyPhase.BUILD]: 'bottom_up.build',
+};
+/** The order a straight-through creation takes the phases in, which is the order they are listed in. */
+export const CREATION_JOURNEY_PHASE_ORDER = [
+    CreationJourneyPhase.DEFINITION,
+    CreationJourneyPhase.COMPLIANCE,
+    CreationJourneyPhase.CONCEPTION,
+    CreationJourneyPhase.BUILD,
+];
+/**
+ * Where a build attempt's DISPATCH WAIT is measured from. It always ends when the run was admitted (its task row's
+ * start instant), or when the attempt ended for one that never started.
+ */
+export var BuildDispatchWaitMeasuredFrom;
+(function (BuildDispatchWaitMeasuredFrom) {
+    /**
+     * The moment the door that dispatched it began preparing it: for a wave slot, checking the backend starts; for the
+     * single-task doors, reading the plan. From there it is resolving landing, selecting the task, composing its brief
+     * and admitting the run — the stretch #3206 found to be most of the build's wall clock. Every dispatch door stamps
+     * it on the attempt's row since #3206.
+     *
+     * It is not quite the interval #3206 tabulated by hand, which ran from the first selection LOG line (possibly a slot
+     * abandoned earlier) to admission. And time between dispatches that no door spends preparing a task — a lane's own
+     * phases between waves, a wave waiting for a slot to free — is attributed to no task.
+     */
+    BuildDispatchWaitMeasuredFrom["PREPARATION"] = "preparation";
+    /**
+     * The moment the attempt's row was opened, which is after the task was chosen and its brief composed. Only a row
+     * recorded before #3206 has no preparation stamp: its wait is a FLOOR of the real one.
+     */
+    BuildDispatchWaitMeasuredFrom["SELECTION"] = "selection";
+})(BuildDispatchWaitMeasuredFrom || (BuildDispatchWaitMeasuredFrom = {}));
+/** One phase's span. Every phase is listed; one that never ran has no instants and no duration. */
+export const CreationJourney_PhaseSpan_Schema = z.object({
+    phase: z.enum(CreationJourneyPhase),
+    laneRef: z.string().min(1),
+    /** The first start of any of its runs. */
+    startedAt: z.string().optional(),
+    /** The last settle of any of its runs, or the read's own instant while one is in flight. */
+    endedAt: z.string().optional(),
+    durationMs: z.number().int().nonnegative().optional(),
+    /** A run of the phase is still in flight, so `endedAt` is the read's instant and the duration is so far. */
+    inFlight: z.boolean(),
+    /** A run of the phase is waiting on a person; its span ends where it began waiting. */
+    waitingOnPerson: z.boolean(),
+    playbookRuns: z.number().int().nonnegative(),
+    /** Build-task attempts counted in the span: only the BUILD phase has any. */
+    buildAttempts: z.number().int().nonnegative(),
+});
+/** One build task with its time split into waiting and running, summed over its attempts. */
+export const CreationJourney_SlowBuildTask_Schema = z.object({
+    taskRef: z.string().min(1),
+    attempts: z.number().int().nonnegative(),
+    /** From being prepared (or selected) to being admitted, over every attempt. */
+    dispatchWaitMs: z.number().int().nonnegative(),
+    /** From being admitted to settling, over every attempt. */
+    runMs: z.number().int().nonnegative(),
+    totalMs: z.number().int().nonnegative(),
+    /** SELECTION when any attempt's wait could only be measured from its row's opening: the wait is then a floor. */
+    dispatchWaitMeasuredFrom: z.enum(BuildDispatchWaitMeasuredFrom),
+    /** An attempt is still waiting or running, so its share is measured up to the read's instant. */
+    inFlight: z.boolean(),
+    /** An attempt is parked on a question to a person; its share ends where it parked. */
+    waitingOnPerson: z.boolean(),
+    /**
+     * An attempt was ended by the startup sweep after a companion restart: the row records no instant the run stopped,
+     * only when the next process settled it, so its share runs to that restart and includes any time the companion was down.
+     */
+    endedByCompanionRestart: z.boolean(),
+    /** A companion generation step (labels, migrations, translations) rather than a coding run. */
+    generationStep: z.boolean(),
+});
+/**
+ * One build-task ATTEMPT's time, split as {@link CreationJourney_SlowBuildTask} splits a task's (#3204's budget). The
+ * slowest-ten list answers "where did the time go"; this list answers "what is the distribution", which a budget is
+ * stated in: the p95 of the dispatch wait and of a worker's run, and how many ran at once. Every attempt the read saw is
+ * listed, oldest first, so a reader computes any statistic without the companion choosing one.
+ */
+export const CreationJourney_BuildAttemptTiming_Schema = z.object({
+    taskRef: z.string().min(1),
+    /** Where the wait is measured from: the preparation start, else the row's opening ({@link BuildDispatchWaitMeasuredFrom}). */
+    startedAt: z.string(),
+    /** When the run was admitted (a coding run started, a generation step opened). Absent for an attempt never admitted. */
+    admittedAt: z.string().optional(),
+    /** Its settle, where it parked on a person, or the read's instant while it is in flight. */
+    endedAt: z.string(),
+    dispatchWaitMs: z.number().int().nonnegative(),
+    runMs: z.number().int().nonnegative(),
+    dispatchWaitMeasuredFrom: z.enum(BuildDispatchWaitMeasuredFrom),
+    inFlight: z.boolean(),
+    waitingOnPerson: z.boolean(),
+    /** Settled by a later companion's startup sweep: `endedAt` is that restart, not when the run stopped. */
+    endedByCompanionRestart: z.boolean(),
+    generationStep: z.boolean(),
+});
+/**
+ * One task of the accepted build plan and the tasks it waits on: the graph that decides when a task COULD have been
+ * dispatched, which an attempt's own instants cannot say. Read from the plan as authored, with no landing pass.
+ */
+export const CreationJourney_BuildPlanTask_Schema = z.object({
+    taskRef: z.string().min(1),
+    prerequisiteTaskRefs: z.array(z.string().min(1)),
+});
+/** What `GET /api/companion/creation/timeline` answers. */
+export const CreationJourney_Timeline_Schema = z.object({
+    generatedAt: z.string(),
+    /** From the first start of anything the journey ran to its last settle (the read's instant while anything runs). */
+    wallClock: z.object({
+        startedAt: z.string(),
+        endedAt: z.string(),
+        durationMs: z.number().int().nonnegative(),
+        inFlight: z.boolean(),
+    }).nullable(),
+    phases: z.array(CreationJourney_PhaseSpan_Schema),
+    /** The slowest build tasks by wait plus run, slowest first, at most {@link CREATION_JOURNEY_SLOWEST_BUILD_TASK_COUNT}. */
+    slowestBuildTasks: z.array(CreationJourney_SlowBuildTask_Schema),
+    /** Build tasks that had any attempt, so a reader knows how many the slowest list was chosen from. */
+    attemptedBuildTasks: z.number().int().nonnegative(),
+    /**
+     * Every build attempt the read saw, oldest first, each split into its dispatch wait and its run (#3204's budget, read
+     * by `scripts/app-creation/creation-budget.mjs`). Absent from a companion older than the budget, which the CLI may
+     * still be reading while the companion process has not restarted onto the new build.
+     */
+    buildAttemptTimings: z.array(CreationJourney_BuildAttemptTiming_Schema).optional(),
+    /**
+     * The accepted build plan's graph (#3204's budget): NULL when the application has no build plan yet, or its plan could
+     * not be read (said in `notChecked`). Absent from a companion older than the budget.
+     */
+    buildPlanGraph: z.array(CreationJourney_BuildPlanTask_Schema).nullable().optional(),
+    /** Playbook runs of no phase's lane: the umbrella itself, the unattended loop's lanes outside the four, refinement. In the wall clock only. */
+    outsidePhasePlaybookRuns: z.number().int().nonnegative(),
+    /** Playbook refs two lanes admit: their runs cannot be placed in one phase, so they are counted in none. */
+    ambiguousPlaybookRefs: z.array(z.string()),
+    /** What this read could not see, each a reason a figure is a floor. */
+    notChecked: z.array(z.string()),
+});
+/** How many of the slowest build tasks the timeline lists: the ten the epic's acceptance asks for. */
+export const CREATION_JOURNEY_SLOWEST_BUILD_TASK_COUNT = 10;
+//# sourceMappingURL=creation-journey-timeline.custom.shared.schemas.js.map

package/dist/esm/workbench/creation-journey-timeline.custom.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creation-journey-timeline.custom.shared.schemas.js","sourceRoot":"","sources":["../../../src/workbench/creation-journey-timeline.custom.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\n/**\n * The creation journey's TIMELINE (#3206, the acceptance of epic #3204): how long each phase of creating an\n * application took, end to end, and which build tasks took longest — split into the time a task waited to be\n * dispatched and the time its run took.\n *\n * ## Why it exists\n *\n * On `app-creation-test-007` creating one application took 3.5 days, and about 75 % of the build's wall clock was a\n * selected task WAITING for its dispatch (22 to 67 minutes a task, against 5 to 23 for the run). Nothing showed it:\n * the figures in #3206 were reconstructed by hand from a log line, `wildo build dispatches` rows and commit times.\n * The timeline is that reconstruction, derived on every read from the rows the companion already keeps — the playbook\n * runs' executions and each build task's attempts — so the next creation run's figures are one command away.\n *\n * ## Where it is derived, and where this contract sits\n *\n * The companion derives it (`deriveCreationJourneyTimeline`) and serves it on `GET /api/companion/creation/timeline`;\n * `wildo context journey` prints it. This file is the shape both read, and the vocabulary both name: the CLI cannot\n * import the companion, so the enums live here, as the other creation-console contracts do.\n */\n\n/**\n * A PHASE of creating an application: one of the four lanes the creation umbrella (`cross_cutting.application-creation`)\n * admits. A phase is the work of its lane — the lane's own runs and every run of a playbook its choreography admits,\n * transitively — not a gate: nothing waits on a phase (`MetaWorkflow_Phase` records why a derived phase was removed as\n * a gate). The phases overlap in time when the lanes do; each one's span is its own first start to its last settle.\n */\nexport enum CreationJourneyPhase {\n  /** What the application is: vision, market, requirements, brand, scope (`top_down.definition`). */\n  DEFINITION = 'definition',\n  /** What the application owes: the compliance posture, its programme and its governed documents (`cross_cutting.compliance`). */\n  COMPLIANCE = 'compliance',\n  /** How it is built: the domain plan, the foundation, the surface plans, placement (`bottom_up.conception`). */\n  CONCEPTION = 'conception',\n  /**\n   * Building it: the build plan's decomposition and every task's dispatch (`bottom_up.build`). Its span also covers\n   * every build-task attempt, whoever started it: a single-task `wildo build run --single`, a workbench dispatch and a\n   * named run start no playbook of the build lane, and their runs are still the build.\n   */\n  BUILD = 'build',\n}\n\n/**\n * The lane composite each phase is the work of: the four lanes `cross_cutting.application-creation` admits. It also\n * admits the vision interview, a leaf (#3386); that stays DEFINITION work because the definition lane admits it too.\n */\nexport const CREATION_JOURNEY_PHASE_LANE_REFS: Readonly<Record<CreationJourneyPhase, string>> = {\n  [CreationJourneyPhase.DEFINITION]: 'top_down.definition',\n  [CreationJourneyPhase.COMPLIANCE]: 'cross_cutting.compliance',\n  [CreationJourneyPhase.CONCEPTION]: 'bottom_up.conception',\n  [CreationJourneyPhase.BUILD]: 'bottom_up.build',\n};\n\n/** The order a straight-through creation takes the phases in, which is the order they are listed in. */\nexport const CREATION_JOURNEY_PHASE_ORDER: readonly CreationJourneyPhase[] = [\n  CreationJourneyPhase.DEFINITION,\n  CreationJourneyPhase.COMPLIANCE,\n  CreationJourneyPhase.CONCEPTION,\n  CreationJourneyPhase.BUILD,\n];\n\n/**\n * Where a build attempt's DISPATCH WAIT is measured from. It always ends when the run was admitted (its task row's\n * start instant), or when the attempt ended for one that never started.\n */\nexport enum BuildDispatchWaitMeasuredFrom {\n  /**\n   * The moment the door that dispatched it began preparing it: for a wave slot, checking the backend starts; for the\n   * single-task doors, reading the plan. From there it is resolving landing, selecting the task, composing its brief\n   * and admitting the run — the stretch #3206 found to be most of the build's wall clock. Every dispatch door stamps\n   * it on the attempt's row since #3206.\n   *\n   * It is not quite the interval #3206 tabulated by hand, which ran from the first selection LOG line (possibly a slot\n   * abandoned earlier) to admission. And time between dispatches that no door spends preparing a task — a lane's own\n   * phases between waves, a wave waiting for a slot to free — is attributed to no task.\n   */\n  PREPARATION = 'preparation',\n  /**\n   * The moment the attempt's row was opened, which is after the task was chosen and its brief composed. Only a row\n   * recorded before #3206 has no preparation stamp: its wait is a FLOOR of the real one.\n   */\n  SELECTION = 'selection',\n}\n\n/** One phase's span. Every phase is listed; one that never ran has no instants and no duration. */\nexport const CreationJourney_PhaseSpan_Schema = z.object({\n  phase: z.enum(CreationJourneyPhase),\n  laneRef: z.string().min(1),\n  /** The first start of any of its runs. */\n  startedAt: z.string().optional(),\n  /** The last settle of any of its runs, or the read's own instant while one is in flight. */\n  endedAt: z.string().optional(),\n  durationMs: z.number().int().nonnegative().optional(),\n  /** A run of the phase is still in flight, so `endedAt` is the read's instant and the duration is so far. */\n  inFlight: z.boolean(),\n  /** A run of the phase is waiting on a person; its span ends where it began waiting. */\n  waitingOnPerson: z.boolean(),\n  playbookRuns: z.number().int().nonnegative(),\n  /** Build-task attempts counted in the span: only the BUILD phase has any. */\n  buildAttempts: z.number().int().nonnegative(),\n});\nexport type CreationJourney_PhaseSpan = z.infer<typeof CreationJourney_PhaseSpan_Schema>;\n\n/** One build task with its time split into waiting and running, summed over its attempts. */\nexport const CreationJourney_SlowBuildTask_Schema = z.object({\n  taskRef: z.string().min(1),\n  attempts: z.number().int().nonnegative(),\n  /** From being prepared (or selected) to being admitted, over every attempt. */\n  dispatchWaitMs: z.number().int().nonnegative(),\n  /** From being admitted to settling, over every attempt. */\n  runMs: z.number().int().nonnegative(),\n  totalMs: z.number().int().nonnegative(),\n  /** SELECTION when any attempt's wait could only be measured from its row's opening: the wait is then a floor. */\n  dispatchWaitMeasuredFrom: z.enum(BuildDispatchWaitMeasuredFrom),\n  /** An attempt is still waiting or running, so its share is measured up to the read's instant. */\n  inFlight: z.boolean(),\n  /** An attempt is parked on a question to a person; its share ends where it parked. */\n  waitingOnPerson: z.boolean(),\n  /**\n   * An attempt was ended by the startup sweep after a companion restart: the row records no instant the run stopped,\n   * only when the next process settled it, so its share runs to that restart and includes any time the companion was down.\n   */\n  endedByCompanionRestart: z.boolean(),\n  /** A companion generation step (labels, migrations, translations) rather than a coding run. */\n  generationStep: z.boolean(),\n});\nexport type CreationJourney_SlowBuildTask = z.infer<typeof CreationJourney_SlowBuildTask_Schema>;\n\n/**\n * One build-task ATTEMPT's time, split as {@link CreationJourney_SlowBuildTask} splits a task's (#3204's budget). The\n * slowest-ten list answers \"where did the time go\"; this list answers \"what is the distribution\", which a budget is\n * stated in: the p95 of the dispatch wait and of a worker's run, and how many ran at once. Every attempt the read saw is\n * listed, oldest first, so a reader computes any statistic without the companion choosing one.\n */\nexport const CreationJourney_BuildAttemptTiming_Schema = z.object({\n  taskRef: z.string().min(1),\n  /** Where the wait is measured from: the preparation start, else the row's opening ({@link BuildDispatchWaitMeasuredFrom}). */\n  startedAt: z.string(),\n  /** When the run was admitted (a coding run started, a generation step opened). Absent for an attempt never admitted. */\n  admittedAt: z.string().optional(),\n  /** Its settle, where it parked on a person, or the read's instant while it is in flight. */\n  endedAt: z.string(),\n  dispatchWaitMs: z.number().int().nonnegative(),\n  runMs: z.number().int().nonnegative(),\n  dispatchWaitMeasuredFrom: z.enum(BuildDispatchWaitMeasuredFrom),\n  inFlight: z.boolean(),\n  waitingOnPerson: z.boolean(),\n  /** Settled by a later companion's startup sweep: `endedAt` is that restart, not when the run stopped. */\n  endedByCompanionRestart: z.boolean(),\n  generationStep: z.boolean(),\n});\nexport type CreationJourney_BuildAttemptTiming = z.infer<typeof CreationJourney_BuildAttemptTiming_Schema>;\n\n/**\n * One task of the accepted build plan and the tasks it waits on: the graph that decides when a task COULD have been\n * dispatched, which an attempt's own instants cannot say. Read from the plan as authored, with no landing pass.\n */\nexport const CreationJourney_BuildPlanTask_Schema = z.object({\n  taskRef: z.string().min(1),\n  prerequisiteTaskRefs: z.array(z.string().min(1)),\n});\nexport type CreationJourney_BuildPlanTask = z.infer<typeof CreationJourney_BuildPlanTask_Schema>;\n\n/** What `GET /api/companion/creation/timeline` answers. */\nexport const CreationJourney_Timeline_Schema = z.object({\n  generatedAt: z.string(),\n  /** From the first start of anything the journey ran to its last settle (the read's instant while anything runs). */\n  wallClock: z.object({\n    startedAt: z.string(),\n    endedAt: z.string(),\n    durationMs: z.number().int().nonnegative(),\n    inFlight: z.boolean(),\n  }).nullable(),\n  phases: z.array(CreationJourney_PhaseSpan_Schema),\n  /** The slowest build tasks by wait plus run, slowest first, at most {@link CREATION_JOURNEY_SLOWEST_BUILD_TASK_COUNT}. */\n  slowestBuildTasks: z.array(CreationJourney_SlowBuildTask_Schema),\n  /** Build tasks that had any attempt, so a reader knows how many the slowest list was chosen from. */\n  attemptedBuildTasks: z.number().int().nonnegative(),\n  /**\n   * Every build attempt the read saw, oldest first, each split into its dispatch wait and its run (#3204's budget, read\n   * by `scripts/app-creation/creation-budget.mjs`). Absent from a companion older than the budget, which the CLI may\n   * still be reading while the companion process has not restarted onto the new build.\n   */\n  buildAttemptTimings: z.array(CreationJourney_BuildAttemptTiming_Schema).optional(),\n  /**\n   * The accepted build plan's graph (#3204's budget): NULL when the application has no build plan yet, or its plan could\n   * not be read (said in `notChecked`). Absent from a companion older than the budget.\n   */\n  buildPlanGraph: z.array(CreationJourney_BuildPlanTask_Schema).nullable().optional(),\n  /** Playbook runs of no phase's lane: the umbrella itself, the unattended loop's lanes outside the four, refinement. In the wall clock only. */\n  outsidePhasePlaybookRuns: z.number().int().nonnegative(),\n  /** Playbook refs two lanes admit: their runs cannot be placed in one phase, so they are counted in none. */\n  ambiguousPlaybookRefs: z.array(z.string()),\n  /** What this read could not see, each a reason a figure is a floor. */\n  notChecked: z.array(z.string()),\n});\nexport type CreationJourney_Timeline = z.infer<typeof CreationJourney_Timeline_Schema>;\n\n/** How many of the slowest build tasks the timeline lists: the ten the epic's acceptance asks for. */\nexport const CREATION_JOURNEY_SLOWEST_BUILD_TASK_COUNT = 10;\n"]}

package/dist/esm/workbench/workbench-aspect-resources.custom.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workbench-aspect-resources.custom.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/workbench/workbench-aspect-resources.custom.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAMrB,oBAAoB,EAKrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAEL,4BAA4B,EAC7B,MAAM,mDAAmD,CAAC;AAM3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;;;GAOG;AACH,oBAAY,2BAA2B;IACrC,mFAAmF;IACnF,YAAY,iBAAiB;IAC7B,8DAA8D;IAC9D,SAAS,cAAc;IACvB,gGAAgG;IAChG,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAAC;IACpD,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAC;CAC1D;AAED,eAAO,MAAM,4BAA4B,EAAE,SAAS,yBAAyB,EAk4B5E,CAAC;AAMF,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAErG;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,yBAAyB,GACpC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAuC5B;AAED,KAAK,8BAA8B,GAAG,qBAAqB,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC;AAE9F;;;;;GAKG;AACH,wBAAgB,wCAAwC,CAAC,UAAU,EAAE,yBAAyB,IAEpF,wBAAwB,oBAAoB,EAAE;;oBA6BvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,IAAI,oBAAoB,EAAE,CA8D1E;AAED,mGAAmG;AACnG,eAAO,MAAM,iDAAiD,EAAE,MAAM,CACpE,MAAM,EACN,UAAU,CAAC,OAAO,wCAAwC,CAAC,CAM5D,CAAC"}
+{"version":3,"file":"workbench-aspect-resources.custom.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/workbench/workbench-aspect-resources.custom.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAMrB,oBAAoB,EAKrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAEL,4BAA4B,EAC7B,MAAM,mDAAmD,CAAC;AAM3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;;;GAOG;AACH,oBAAY,2BAA2B;IACrC,mFAAmF;IACnF,YAAY,iBAAiB;IAC7B,8DAA8D;IAC9D,SAAS,cAAc;IACvB,gGAAgG;IAChG,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAAC;IACpD,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,6BAA6B,EAAE,CAAC;CAC1D;AAED,eAAO,MAAM,4BAA4B,EAAE,SAAS,yBAAyB,EAg7B5E,CAAC;AAMF,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAErG;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,yBAAyB,GACpC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAuC5B;AAED,KAAK,8BAA8B,GAAG,qBAAqB,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC;AAE9F;;;;;GAKG;AACH,wBAAgB,wCAAwC,CAAC,UAAU,EAAE,yBAAyB,IAEpF,wBAAwB,oBAAoB,EAAE;;oBA6BvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,IAAI,oBAAoB,EAAE,CA8D1E;AAED,mGAAmG;AACnG,eAAO,MAAM,iDAAiD,EAAE,MAAM,CACpE,MAAM,EACN,UAAU,CAAC,OAAO,wCAAwC,CAAC,CAM5D,CAAC"}

package/dist/esm/workbench/workbench-aspect-resources.custom.shared.schemas.js

@@ -88,6 +88,14 @@ export const WORKBENCH_ASPECT_DESCRIPTORS = [
         identity: WorkbenchAspectIdentityKind.BUSINESS_KEY,
         edges: [],
     },
+    {
+        /* A regime research established (#3362): prose, keyed by its own ref, naming no row of another family. */
+        aspectKey: 'compliance-posture.constraint',
+        resourceType: WorkbenchShared_ResourceType.ASPECT_COMPLIANCE_POSTURE_CONSTRAINT,
+        rowsPath: 'compliancePostureConstraints',
+        identity: WorkbenchAspectIdentityKind.BUSINESS_KEY,
+        edges: [],
+    },
     {
         aspectKey: 'market.category',
         resourceType: WorkbenchShared_ResourceType.ASPECT_MARKET_CATEGORY,
@@ -533,6 +541,42 @@ export const WORKBENCH_ASPECT_DESCRIPTORS = [
             { field: 'resourceIds', targetAspectKey: 'domain-plan.resource', many: true },
         ],
     },
+    /*
+     * The organization model (#3032): the organization types, the relationship kinds between them (whose two sides point
+     * back at the types), the confined records and the records held in a system of record (both pointing at the resource).
+     */
+    {
+        aspectKey: 'domain-plan.organization-type',
+        resourceType: WorkbenchShared_ResourceType.ASPECT_DOMAIN_PLAN_ORGANIZATION_TYPE,
+        rowsPath: 'domainPlanOrganizationTypes',
+        identity: WorkbenchAspectIdentityKind.BUSINESS_KEY,
+        edges: [],
+    },
+    {
+        aspectKey: 'domain-plan.relationship-kind',
+        resourceType: WorkbenchShared_ResourceType.ASPECT_DOMAIN_PLAN_RELATIONSHIP_KIND,
+        rowsPath: 'domainPlanRelationshipKinds',
+        identity: WorkbenchAspectIdentityKind.BUSINESS_KEY,
+        edges: [
+            // Two registry fields reach the same target, and the SIDE is the decision, so each keeps its own spine field.
+            { field: 'representingTypeIds', targetAspectKey: 'domain-plan.organization-type', many: true, sourceField: 'representingTypes' },
+            { field: 'grantingTypeIds', targetAspectKey: 'domain-plan.organization-type', many: true, sourceField: 'grantingTypes' },
+        ],
+    },
+    {
+        aspectKey: 'domain-plan.unit-confinement',
+        resourceType: WorkbenchShared_ResourceType.ASPECT_DOMAIN_PLAN_UNIT_CONFINEMENT,
+        rowsPath: 'domainPlanUnitConfinements',
+        identity: WorkbenchAspectIdentityKind.INDEXED,
+        edges: [{ field: 'resourceId', targetAspectKey: 'domain-plan.resource', many: false }],
+    },
+    {
+        aspectKey: 'domain-plan.record-location',
+        resourceType: WorkbenchShared_ResourceType.ASPECT_DOMAIN_PLAN_RECORD_LOCATION,
+        rowsPath: 'domainPlanRecordLocations',
+        identity: WorkbenchAspectIdentityKind.BUSINESS_KEY,
+        edges: [{ field: 'resourceId', targetAspectKey: 'domain-plan.resource', many: false }],
+    },
     {
         aspectKey: 'build-plan.task',
         resourceType: WorkbenchShared_ResourceType.ASPECT_BUILD_TASK,
@@ -561,6 +605,8 @@ export const WORKBENCH_ASPECT_DESCRIPTORS = [
             /* The vision edges (#629) — see the registry for why a build task may serve these. */
             { field: 'servesSuccessCriterionIds', targetAspectKey: 'vision.success-criterion', many: true },
             { field: 'servesConstraintIds', targetAspectKey: 'vision.constraint', many: true },
+            /* A researched regime the task lands (#3362), since the posture has its own family. */
+            { field: 'servesPostureConstraintIds', targetAspectKey: 'compliance-posture.constraint', many: true },
             /*
              * The experience plan's entries on the PRODUCT side (#1660): a view, milestone or guidance task
              * names the entry it builds by the plan's own ref, so the task links to the decision.