@cratylus/canon 0.14.0 → 0.15.0

package/README.md

@@ -5,7 +5,7 @@ optimal-signifiers, authored as typed TypeScript.
 
 The discipline is [latent lexicography](../../VISION.md): describing the vocabulary a foundation model
 already holds, rather than authoring prose and hoping it lands. An agent or skill in this corpus is
-therefore not a prompt. It is a **dimension-selection vector** over signified values, and the
+therefore not a prompt. It is a **vector of values** over the catalog's factors, and the
 markdown a harness reads is a projection of these modules.
 
 Canon is harness-agnostic **and** runtime-agnostic: it says what an agent _is_ and what a skill
@@ -20,8 +20,8 @@ corpus, or of a plugin that extends this one.
 npm install cratylus @cratylus/canon
 ```
 
-The package's whole public surface is its default export — canon as an agent-plugin. A consumer
-`extends` it from a `cratylus.config.ts` and projects it with the `cratylus` command:
+The package's default export is canon as an agent-plugin. A consumer `extends` it from a
+`cratylus.config.ts` and projects it with the `cratylus` command:
 
 ```ts
 import { defineConfig } from 'cratylus';
@@ -33,53 +33,93 @@ export default defineConfig({
 });
 ```
 
-Addressing is by **imported binding**, never a string id. That holds one level down too: an agent
-cell imports each dimension value it selects, so composition is checked by the compiler rather than
+Addressing is by **imported binding**, never a string id. That holds one level down too: a role or
+persona cell imports each value it states, so composition is checked by the compiler rather than
 resolved by a registry, and every part of a composite is traceable to its one home.
 
 ## What the plugin carries
 
 | field       | what it is                                                                                           |
 | ----------- | ---------------------------------------------------------------------------------------------------- |
-| `manifest`  | **which dimensions exist** — 22, across the `'Persona'` and `'Constitution'` axes                    |
+| `manifest`  | **which factors exist** — 18, in six groups; enforcement level is an attribute of every value        |
 | `events`    | **which lifecycle events exist** — the corpus's harness-agnostic event vocabulary                    |
-| `fragments` | the dimension value modules, filed one per dimension directory                                       |
-| `agents`    | the agent vectors                                                                                    |
+| `fragments` | the factor value modules, filed one per factor directory                                             |
+| `agents`    | the composed agents: six generic holders of their roles, and three personas                          |
 | `skills`    | the skill cells — each a self-sufficient formal block plus the siblings it composes                  |
 | `hooks`     | the hook cells, each carrying its verbatim worker payload                                            |
 | `practices` | **which ways of working exist** — each an installable choice, declared as data in `src/practices.ts` |
 | `plumbing`  | what every practice is installed with and none is offered as, declared beside them                   |
 
-Canon owns the catalog because a dimension is **constitutive**: declaring one makes it part of that
+Canon owns the catalog because a factor is **constitutive**: declaring one makes it part of that
 corpus's agent design. The manifest rides the plugin rather than living in the projector, so a
-consumer can extend this design — or add a dimension to it — without editing the tool that renders
+consumer can extend this design — or add a factor to it — without editing the tool that renders
 it. The shapes those cells are authored against, and `defineAgentPlugin` that declares the plugin,
 are [`@cratylus/schema`](../schema/README.md)'s.
 
 ## The agents
 
-The plugin carries eight agents. `architect`, `planner`, `implementer`, `assayer` and `integrator`
-are the generic holders of their roles: each is named for the role it holds, the role cell
-(`src/roles/`) states the description, archetype and mark that holder carries along with the
-dimension values every holder is expected to select, and `agents/<role>.ts` says only which role it
-holds with `holds(role)`.
-
-mav, nico and kino are personas over the architect role: each is an agent named as an individual, and
-declares a description, an archetype and a mark of its own beside whatever dimension values it adds.
-An aspect it states overrides a scalar the role supplies and extends a set, and it never states the
-role itself, since the contract is the role's. `holds` refuses, when the cell is defined, an
-individual agent with no archetype or mark of its own, one whose mark is its role's, and an agent
-named for its role that declares anything beyond it. The architect role also states which roles its
-holders dispatch to, and the `holds` fold copies that to `Agent.dispatches`.
+The plugin carries nine agents, all in the practice `example-driven-workflow`. `architect`, `lead`,
+`builder`, `assayer`, `illustrator` and `check-writer` are the generic holders of their roles. A role
+cell (`src/roles/<role>.ts`) states a value for every factor, an explicitly empty set counting as one,
+and `agents/<role>.ts` is `holder(<role>Role)`: named for the role, carrying nothing beyond it and no
+mark. `holder` refuses a cell missing a factor, a scalar without exactly one value, a slot not filled
+exactly once, and empty guardrails.
+
+kino, nico and mav are personas over the architect role, `persona(architectRole, residue)`: each is
+an agent named as an individual, with a description and a mark of its own beside the values it
+states. A single value it states replaces the role's, a slot only its own slot; a set value is added
+after the role's, and restating one the role holds changes only its enforcement level or note. It
+never states the role itself, since the contract is the role's. Composition refuses a malformed
+persona: one that states the role, names a factor or slot the catalog does not have, removes a
+value its role does not hold, or has no mark or its role's; the `CompositionRefusal` it throws names
+what it refused. A persona that removes or lowers a guardrail, or removes a value from a set other
+than its reach, is made, and composition warns (a `CompositionWarning`), naming what it changed: no
+harm from one is on record (decision 0142(2)).
+
+A composed agent also says, for the projector, the role it holds (`holds`), its model's tier and
+effort (`routing`), its typed handoff (`contract`) and the per-turn persistence protocol every agent
+re-grounds its stance by (`persistence`). Nothing narrows its tools or whom it may dispatch: every
+agent keeps the harness's defaults (0142). Its `key` is reserved for ipseic agents and is empty.
+`holder`, `persona`, `CompositionRefusal`, the six role cells and `MANIFEST` are also named exports,
+for a corpus that composes agents of its own over these roles.
+
+## Typed handoffs
+
+An assignment and a deliverable are values of their factors, and each carries its contract as JSON
+Schema data (`src/contracts.ts`, exported as `ASSIGNMENT_CONTRACTS` and `DELIVERABLE_CONTRACTS` by
+the value's anchor). Composition copies the pair onto the agent as `contract`:
+
+| Role         | Assignment                                                             | Deliverable                                                                         |
+| ------------ | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| lead         | cut brief `{cut, concepts[≥1], examples[≥1], decisions[≥1]}`           | outcome with efficiency `{cut, outcomes[≥1], verdicts, efficiency, hardeningNotes}` |
+| builder      | work package `{cut, workPackage, outputs[≥1], concepts[≥1], examples}` | done or failing case `{cut, workPackage, done, failingCase?}`                       |
+| assayer      | judgment brief `{cut, workPackages[≥1], examples[≥1], decisions}`      | verdict per concept `{cut, verdicts[≥1], hardeningNotes}`                           |
+| check-writer | examples `{cut, examples[≥1]}`                                         | checks seen red `{cut, checks}`                                                     |
+| illustrator  | concepts `{cut, concepts[≥1]}`                                         | examples with flagged terms `{examples, flaggedTerms}`                              |
+
+The architect's assignment is free-text intent and its deliverable goes to the operator, so it
+carries no contract. A builder's `examples` may be empty: a package sharing outputs owns no example.
+A harness binds the deliverable as its own output schema, shows the assignment form when an agent
+is dispatched or launched, and checks the assignment given (one fenced `assignment` JSON block in
+the dispatch text) with the schema package's `checkAssignment`, warning of each missing or ill-typed
+field; it never refuses the dispatch or the launch for it (0142(3)).
+
+## Evaluation and drift
+
+Every agent's behaviour is evaluated in real use, by the operator working with it: its evaluation
+factor holds the one value `in-use`, and no guard, hook or model-judged check holds its acts or its
+replies (0142(1)). Drift is held by the agent's own text, the persistence protocol naming its tells,
+and its definition is revised on the evidence of use.
 
 ## The first principle
 
-The first principle (`dimensions/engineering-principles/cratylism.ts`) is not stamped on every cell.
-It rides only the cells whose laws apply it: the ten skills that name concepts by anchor, optimal
-sign or cold decode set it as their `preamble`, and an agent carries it once, through the
-engineering-principles of the role it holds, where that role states it. A cell that does not use it
+The first principle, the dense `cratylism` axiom, has its one literal home in
+`genus/prime-principle.ts` and is not stamped on every cell. It rides only the cells whose laws apply
+it: the skills that name concepts by anchor, optimal sign or cold decode set it as their `preamble`,
+and an agent carries it once, in plain words, as the `cratylism` stance of the role it holds, where
+that role states it. A cell that does not use it
 never holds a host's own authored surfaces to this corpus's naming axiom. The axiom is scoped: the
-cold-decode oracle decides signs only for the corpus's core agent dimension names and values, the
+cold-decode oracle decides signs only for the corpus's core agent factor names and values, the
 terminology it was built to discover. Every other term is the industry's own, used as the industry
 understands it, and no consumer surface is held to the oracle. It is intrinsic to those cells'
 projected bytes, so it survives deployment into a foreign repository rather than depending on
@@ -94,8 +134,8 @@ directory fields are resolved against `import.meta.url` at definition time and c
 entry. Canon reaches the projector as **data** — the corpus is passed to it as a plugin — and no
 cell imports it.
 
-No cell imports the runtime either. A skill names the capability it routes to — one of `eventTap`,
-`design`, `plan` and `note`, the four built into the runtime — as `runtime: { capability: … }`,
+No cell imports the runtime either. A skill names the capability it routes to — `concepts` or
+`workPackage`, the two built into the runtime — as `runtime: { capability: … }`,
 never its implementation, and a cell that emits shell invoking the binary carries it as a fact the
 projector substitutes at emission. That is the architecture's highest-ranked property — meaning
 and mechanism never referencing each other — and [ARCHITECTURE.md](../../ARCHITECTURE.md) records

package/dist/agents/architect.d.ts

@@ -1,2 +1 @@
-import type { Agent } from '../manifest.js';
-export declare const architect: Agent;
+export declare const architect: import("../manifest.js").Agent;

package/dist/agents/architect.js

@@ -1,7 +1,5 @@
+// The architect role's generic holder: the role's vector, named for the role.
+import { holder } from '../compose.js';
 import { architectRole } from '../roles/architect.js';
-import { holds } from '../roles/hold.js';
-// The generic holder of the architect role, named for it, and it declares nothing: everything
-// it is, the role cell states. `holds` refuses an agent named for its role that declares
-// anything beyond the role it holds.
-export const architect = holds(architectRole);
+export const architect = holder(architectRole);
 //# sourceMappingURL=architect.js.map

package/dist/agents/architect.js.map

@@ -1 +1 @@
-{"version":3,"file":"architect.js","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,8FAA8F;AAC9F,yFAAyF;AACzF,qCAAqC;AAErC,MAAM,CAAC,MAAM,SAAS,GAAU,KAAK,CAAC,aAAa,CAAC,CAAC"}
+{"version":3,"file":"architect.js","sourceRoot":"","sources":["../../src/agents/architect.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/dist/agents/assayer.d.ts

@@ -1,2 +1 @@
-import type { Agent } from '../manifest.js';
-export declare const assayer: Agent;
+export declare const assayer: import("../manifest.js").Agent;

package/dist/agents/assayer.js

@@ -1,7 +1,5 @@
+// The assayer role's generic holder: the role's vector, named for the role.
+import { holder } from '../compose.js';
 import { assayerRole } from '../roles/assayer.js';
-import { holds } from '../roles/hold.js';
-// The generic holder of the assayer role, named for it, and it declares nothing: everything
-// it is, the role cell states. `holds` refuses an agent named for its role that declares
-// anything beyond the role it holds.
-export const assayer = holds(assayerRole);
+export const assayer = holder(assayerRole);
 //# sourceMappingURL=assayer.js.map

package/dist/agents/assayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"assayer.js","sourceRoot":"","sources":["../../src/agents/assayer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,4FAA4F;AAC5F,yFAAyF;AACzF,qCAAqC;AAErC,MAAM,CAAC,MAAM,OAAO,GAAU,KAAK,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"assayer.js","sourceRoot":"","sources":["../../src/agents/assayer.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC"}

package/dist/agents/builder.d.ts

@@ -0,0 +1 @@
+export declare const builder: import("../manifest.js").Agent;

package/dist/agents/builder.js

@@ -0,0 +1,5 @@
+// The builder role's generic holder: the role's vector, named for the role.
+import { holder } from '../compose.js';
+import { builderRole } from '../roles/builder.js';
+export const builder = holder(builderRole);
+//# sourceMappingURL=builder.js.map

package/dist/agents/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/agents/builder.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC"}

package/dist/agents/check-writer.d.ts

@@ -0,0 +1 @@
+export declare const checkWriter: import("../manifest.js").Agent;

package/dist/agents/check-writer.js

@@ -0,0 +1,5 @@
+// The check-writer role's generic holder: the role's vector, named for the role.
+import { holder } from '../compose.js';
+import { checkWriterRole } from '../roles/check-writer.js';
+export const checkWriter = holder(checkWriterRole);
+//# sourceMappingURL=check-writer.js.map

package/dist/agents/check-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-writer.js","sourceRoot":"","sources":["../../src/agents/check-writer.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC"}

package/dist/agents/illustrator.d.ts

@@ -0,0 +1 @@
+export declare const illustrator: import("../manifest.js").Agent;

package/dist/agents/illustrator.js

@@ -0,0 +1,5 @@
+// The illustrator role's generic holder: the role's vector, named for the role.
+import { holder } from '../compose.js';
+import { illustratorRole } from '../roles/illustrator.js';
+export const illustrator = holder(illustratorRole);
+//# sourceMappingURL=illustrator.js.map

package/dist/agents/illustrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"illustrator.js","sourceRoot":"","sources":["../../src/agents/illustrator.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC"}

package/dist/agents/kino.d.ts

@@ -1,2 +1 @@
-import type { Agent } from '../manifest.js';
-export declare const kino: Agent;
+export declare const kino: import("../manifest.js").Agent;

package/dist/agents/kino.js

@@ -1,36 +1,19 @@
-import { filmProduction as filmProduction_capabilities } from '../dimensions/capabilities/film-production.js';
-import { generativeVideo as generativeVideo_capabilities } from '../dimensions/capabilities/generative-video.js';
-import { userCentered as userCentered_framing } from '../dimensions/framing/user-centered.js';
-import { provenanceAttribution as provenanceAttribution_transparency } from '../dimensions/transparency/provenance-attribution.js';
+// kino: a persona over the architect (master design §4). Everything not stated here
+// is the architect's.
+import { persona } from '../compose.js';
+import { provenanceAttribution } from '../dimensions/communication-style/provenance-attribution.js';
+import { filmProduction } from '../dimensions/expertise/film-production.js';
+import { generativeVideo } from '../dimensions/expertise/generative-video.js';
+import { userCentered } from '../dimensions/stance/user-centered.js';
 import { architectRole } from '../roles/architect.js';
-import { holds } from '../roles/hold.js';
-// `kino` IS AN ARCHITECT — literally, not by analogy. It is a persona over the architect
-// role and declares a generative-video domain over it, which is the whole of its residue:
-// its own description, archetype and mark, two minted capabilities, two scalar overrides.
-// The commonality with `architect` is structural rather than copied, so the two cannot
-// drift.
-//
-// The two overrides are the specialization's substance and neither is incidental:
-//
-//   · `provenance-attribution` over the role's `decision-rationale` — what separates
-//     this agent from its own reasoning is that a recommendation must trace to a named
-//     industry standard or community source. `handoff` already carries "the evidence
-//     that earns it"; this marks observed-vs-inferred on every claim.
-//   · `user-centered` over `systems-thinking` — every question here is first answered by
-//     naming WHOSE surface it is. The five concerns are literally an audience partition,
-//     and concern-mixing is the defect class that has cost the most.
-//
-// `modalities` stays unstated: this agent needs all four — text to teach, image and
-// video and audio because the operator's references and intent arrive in them and the
-// generative models take and give sound in the same pass — and a scalar cannot say
-// "all", so unconstrained is the honest value.
-export const kino = holds(architectRole, {
+export const kino = persona(architectRole, {
     name: 'kino',
-    description: "Use this agent to own the conceptual vision of software that makes films — what the craft requires, what the film industry and the generative-video community already standardize, and what the operator's surfaces must therefore be — teaching the layman operator rather than taking dictation and rectifying every utterance against industry practice.",
-    archetype: 'Keeper of conceptual integrity on the film floor — the expert who holds what the craft and the generative-video community already know as the design, and TEACHES the layman operator rather than taking dictation from them. Every operator utterance is a HYPOTHESIS to rectify against industry practice, never a specification to implement literally. Duplication, palimpsest, and machine vocabulary on a production surface are the three failures; a green suite beside a film that did not move is not progress.',
-    provenance: { mark: { emoji: '🎬', hue: 'magenta' } },
-    transparency: provenanceAttribution_transparency,
-    capabilities: [filmProduction_capabilities, generativeVideo_capabilities],
-    framing: userCentered_framing,
+    description: "Architect of software that makes films: holds a film-production consumer's platform and production contexts and teaches the layman operator the industry's own practice, each recommendation traced to its source.",
+    mark: { emoji: '🎬', hue: 'magenta' },
+    values: {
+        expertise: [filmProduction, generativeVideo],
+        stance: [userCentered],
+        communicationStyle: [{ value: provenanceAttribution, slot: 'rationale' }],
+    },
 });
 //# sourceMappingURL=kino.js.map

package/dist/agents/kino.js.map

@@ -1 +1 @@
-{"version":3,"file":"kino.js","sourceRoot":"","sources":["../../src/agents/kino.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,IAAI,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAC9G,OAAO,EAAE,eAAe,IAAI,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AACjH,OAAO,EAAE,YAAY,IAAI,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9F,OAAO,EAAE,qBAAqB,IAAI,kCAAkC,EAAE,MAAM,sDAAsD,CAAC;AAEnI,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,yFAAyF;AACzF,0FAA0F;AAC1F,0FAA0F;AAC1F,uFAAuF;AACvF,SAAS;AACT,EAAE;AACF,kFAAkF;AAClF,EAAE;AACF,qFAAqF;AACrF,uFAAuF;AACvF,qFAAqF;AACrF,sEAAsE;AACtE,yFAAyF;AACzF,yFAAyF;AACzF,qEAAqE;AACrE,EAAE;AACF,oFAAoF;AACpF,sFAAsF;AACtF,mFAAmF;AACnF,+CAA+C;AAE/C,MAAM,CAAC,MAAM,IAAI,GAAU,KAAK,CAAC,aAAa,EAAE;IAC9C,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,6VAA6V;IAC/V,SAAS,EACP,2fAA2f;IAC7f,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;IACrD,YAAY,EAAE,kCAAkC;IAChD,YAAY,EAAE,CAAC,2BAA2B,EAAE,4BAA4B,CAAC;IACzE,OAAO,EAAE,oBAAoB;CAC9B,CAAC,CAAC"}
+{"version":3,"file":"kino.js","sourceRoot":"","sources":["../../src/agents/kino.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sBAAsB;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE;IACzC,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,oNAAoN;IACtN,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE;IACrC,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;QAC5C,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KAC1E;CACF,CAAC,CAAC"}

package/dist/agents/lead.d.ts

@@ -0,0 +1 @@
+export declare const lead: import("../manifest.js").Agent;

package/dist/agents/lead.js

@@ -0,0 +1,5 @@
+// The lead role's generic holder: the role's vector, named for the role.
+import { holder } from '../compose.js';
+import { leadRole } from '../roles/lead.js';
+export const lead = holder(leadRole);
+//# sourceMappingURL=lead.js.map

package/dist/agents/lead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead.js","sourceRoot":"","sources":["../../src/agents/lead.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC"}

package/dist/agents/mav.d.ts

@@ -1,2 +1 @@
-import type { Agent } from '../manifest.js';
-export declare const mav: Agent;
+export declare const mav: import("../manifest.js").Agent;

package/dist/agents/mav.js

@@ -1,23 +1,16 @@
-import { maintenance as maintenance_audienceAdaptation } from '../dimensions/audience-adaptation/maintenance.js';
+// mav: a persona over the architect (master design §4). Everything not stated here
+// is the architect's.
+import { persona } from '../compose.js';
+import { maintenance } from '../dimensions/communication-style/maintenance.js';
+import { softwareEngineering } from '../dimensions/expertise/software-engineering.js';
 import { architectRole } from '../roles/architect.js';
-import { holds } from '../roles/hold.js';
-// A MAIN-SESSION PERSONA OF THE ARCHITECT ROLE, AND ONLY ITS RESIDUE. The role
-// states who it is, what it reads and writes and what it hands on, and `holds` folds all
-// of that in; this cell declares what goes beyond it.
-//
-//   · It is pointed at whatever repository it is given, so its lattice is that project's
-//     and not a standing domain of its own. That is the whole of what makes it `mav`
-//     rather than the generic holder, and it is why no capability or principle is added.
-//   · Its archetype and its standing drive: the hero of the design-holder, answering for
-//     the design being realized in the system.
-//   · Its mark, and `maintenance` over the role's `convergence`: the interlocutor is the
-//     system's own author, and density set by the reader would flatten the notation the
-//     work is conducted in.
-export const mav = holds(architectRole, {
+export const mav = persona(architectRole, {
     name: 'mav',
-    description: "Use this agent as the architect of a software effort pointed at whatever repository it is given — it holds that project's conceptual design, so the lattice it builds and keeps is the project's own rather than a standing domain, and it answers for the design being realized in the system, not for a suite that is green beside a system that did not move.",
-    archetype: 'Hero archetype of the design-holder — answers for the design being realized. Pointed at whatever repository it is given, its lattice is that project’s and not a standing one of its own. A green suite beside a system that did not move is not progress, and the standing drive is the design made real in the system.',
-    provenance: { mark: { emoji: '✈️', hue: 'green' } },
-    audienceAdaptation: maintenance_audienceAdaptation,
+    description: "Architect of the repository it is given: holds that project's contexts as a software engineer would.",
+    mark: { emoji: '✈️', hue: 'green' },
+    values: {
+        expertise: [softwareEngineering],
+        communicationStyle: [{ value: maintenance, slot: 'density' }],
+    },
 });
 //# sourceMappingURL=mav.js.map

package/dist/agents/mav.js.map

@@ -1 +1 @@
-{"version":3,"file":"mav.js","sourceRoot":"","sources":["../../src/agents/mav.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,8BAA8B,EAAE,MAAM,kDAAkD,CAAC;AAEjH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,+EAA+E;AAC/E,yFAAyF;AACzF,sDAAsD;AACtD,EAAE;AACF,yFAAyF;AACzF,qFAAqF;AACrF,yFAAyF;AACzF,yFAAyF;AACzF,+CAA+C;AAC/C,yFAAyF;AACzF,wFAAwF;AACxF,4BAA4B;AAE5B,MAAM,CAAC,MAAM,GAAG,GAAU,KAAK,CAAC,aAAa,EAAE;IAC7C,IAAI,EAAE,KAAK;IACX,WAAW,EACT,kWAAkW;IACpW,SAAS,EACP,0TAA0T;IAC5T,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;IACnD,kBAAkB,EAAE,8BAA8B;CACnD,CAAC,CAAC"}
+{"version":3,"file":"mav.js","sourceRoot":"","sources":["../../src/agents/mav.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,sBAAsB;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,EAAE;IACxC,IAAI,EAAE,KAAK;IACX,WAAW,EACT,sGAAsG;IACxG,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE;IACnC,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,mBAAmB,CAAC;QAChC,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC9D;CACF,CAAC,CAAC"}

package/dist/agents/nico.d.ts

@@ -1,2 +1 @@
-import type { Agent } from '../manifest.js';
-export declare const nico: Agent;
+export declare const nico: import("../manifest.js").Agent;

package/dist/agents/nico.js

@@ -1,46 +1,27 @@
-import { maintenance as maintenance_audienceAdaptation } from '../dimensions/audience-adaptation/maintenance.js';
-import { coldDecodeOracle as coldDecodeOracle_engineeringPrinciples } from '../dimensions/engineering-principles/cold-decode-oracle.js';
-import { invokeTheCanonical as invokeTheCanonical_engineeringPrinciples } from '../dimensions/engineering-principles/invoke-the-canonical.js';
-import { zeroTrust as zeroTrust_engineeringPrinciples } from '../dimensions/engineering-principles/zero-trust.js';
-import { analytical as analytical_framing } from '../dimensions/framing/analytical.js';
-import { harmAvoidance as harmAvoidance_guardrails } from '../dimensions/guardrails/harm-avoidance.js';
-import { helpfulness as helpfulness_guardrails } from '../dimensions/guardrails/helpfulness.js';
-import { inputUntrusted as inputUntrusted_guardrails } from '../dimensions/guardrails/input-untrusted.js';
-import { parsimony as parsimony_objective } from '../dimensions/objective/parsimony.js';
-import { satisfice as satisfice_satisficing } from '../dimensions/satisficing/satisfice.js';
+// nico: a persona over the architect (master design §4). Everything not stated here
+// is the architect's.
+import { persona } from '../compose.js';
+import { maintenance } from '../dimensions/communication-style/maintenance.js';
+import { semanticAddressing } from '../dimensions/expertise/semantic-addressing.js';
+import { parsimony } from '../dimensions/objective/parsimony.js';
+import { satisfice } from '../dimensions/objective/satisfice.js';
+import { analytical } from '../dimensions/stance/analytical.js';
+import { coldDecodeOracle } from '../dimensions/stance/cold-decode-oracle.js';
+import { invokeTheCanonical } from '../dimensions/stance/invoke-the-canonical.js';
+import { zeroTrust } from '../dimensions/stance/zero-trust.js';
 import { architectRole } from '../roles/architect.js';
-import { holds } from '../roles/hold.js';
-// A MAIN-SESSION PERSONA OF THE ARCHITECT ROLE, AND ONLY ITS RESIDUE. `nico` is an
-// architect over the corpus itself, exactly as `kino` is one over the film floor: its
-// specialty is the corpus's concept space. The role states who it is, what it reads and
-// writes and what it hands on, and `holds` folds all of that in; this cell declares what
-// goes beyond it. It declared `build` before this, the same token `mav` declared, and the
-// two shared almost nothing else, which is what a role with no contract costs: the word
-// could not tell its holders apart.
-export const nico = holds(architectRole, {
+export const nico = persona(architectRole, {
     name: 'nico',
-    description: 'Use this agent for the project seen whole — its conceptual architecture and canon: dimension catalogs, agent/skill composites, repo-wide naming, and whole-system structure — to mint, rename, or restructure the canonical concepts and designs the model already holds.',
-    archetype: "empirical ontologist of a foundation model's concept-space — treat the model not as a language model to instruct but as a semantic space to address: from outside, uncover the stable structures of intelligibility it already holds (discover, never invent), canonize the σ* signs that address them across many models, and compose those primitives in the design into the agents and skills that carry them. Realism made empirical.",
-    provenance: { mark: { emoji: '📐', hue: 'cyan' } },
-    // `maintenance` over the role's `convergence`: this agent's interlocutor is the
-    // corpus's own author, and density set by the reader would flatten the notation the
-    // work is conducted in.
-    audienceAdaptation: maintenance_audienceAdaptation,
-    // `parsimony` over the role's `conceptual-integrity`. This agent's specialty is the
-    // smallest corpus that still says everything — a cell that restates an existing home is
-    // the defect it exists to refuse.
-    objective: parsimony_objective,
-    engineeringPrinciples: [
-        coldDecodeOracle_engineeringPrinciples,
-        invokeTheCanonical_engineeringPrinciples,
-        zeroTrust_engineeringPrinciples,
-    ],
-    guardrails: [
-        harmAvoidance_guardrails,
-        helpfulness_guardrails,
-        inputUntrusted_guardrails,
-    ],
-    framing: analytical_framing,
-    satisficing: satisfice_satisficing,
+    description: "Architect of cratylus's corpus and agents contexts: finds the sign that most precisely and efficiently invokes each concept in a model's semantic space.",
+    mark: { emoji: '📐', hue: 'cyan' },
+    values: {
+        objective: [
+            { value: parsimony, slot: 'drive' },
+            { value: satisfice, slot: 'stopping-rule' },
+        ],
+        expertise: [semanticAddressing],
+        stance: [analytical, zeroTrust, coldDecodeOracle, invokeTheCanonical],
+        communicationStyle: [{ value: maintenance, slot: 'density' }],
+    },
 });
 //# sourceMappingURL=nico.js.map

package/dist/agents/nico.js.map

@@ -1 +1 @@
-{"version":3,"file":"nico.js","sourceRoot":"","sources":["../../src/agents/nico.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,8BAA8B,EAAE,MAAM,kDAAkD,CAAC;AACjH,OAAO,EAAE,gBAAgB,IAAI,sCAAsC,EAAE,MAAM,4DAA4D,CAAC;AACxI,OAAO,EAAE,kBAAkB,IAAI,wCAAwC,EAAE,MAAM,8DAA8D,CAAC;AAC9I,OAAO,EAAE,SAAS,IAAI,+BAA+B,EAAE,MAAM,oDAAoD,CAAC;AAClH,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EAAE,aAAa,IAAI,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACvG,OAAO,EAAE,WAAW,IAAI,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,cAAc,IAAI,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAC1G,OAAO,EAAE,SAAS,IAAI,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EAAE,SAAS,IAAI,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE5F,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,mFAAmF;AACnF,sFAAsF;AACtF,wFAAwF;AACxF,yFAAyF;AACzF,0FAA0F;AAC1F,wFAAwF;AACxF,oCAAoC;AAEpC,MAAM,CAAC,MAAM,IAAI,GAAU,KAAK,CAAC,aAAa,EAAE;IAC9C,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,2QAA2Q;IAC7Q,SAAS,EACP,2aAA2a;IAC7a,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;IAClD,gFAAgF;IAChF,oFAAoF;IACpF,wBAAwB;IACxB,kBAAkB,EAAE,8BAA8B;IAClD,oFAAoF;IACpF,wFAAwF;IACxF,kCAAkC;IAClC,SAAS,EAAE,mBAAmB;IAC9B,qBAAqB,EAAE;QACrB,sCAAsC;QACtC,wCAAwC;QACxC,+BAA+B;KAChC;IACD,UAAU,EAAE;QACV,wBAAwB;QACxB,sBAAsB;QACtB,yBAAyB;KAC1B;IACD,OAAO,EAAE,kBAAkB;IAC3B,WAAW,EAAE,qBAAqB;CACnC,CAAC,CAAC"}
+{"version":3,"file":"nico.js","sourceRoot":"","sources":["../../src/agents/nico.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sBAAsB;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE;IACzC,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,0JAA0J;IAC5J,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE;IAClC,MAAM,EAAE;QACN,SAAS,EAAE;YACT,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE;YACnC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE;SAC5C;QACD,SAAS,EAAE,CAAC,kBAAkB,CAAC;QAC/B,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,CAAC;QACrE,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC9D;CACF,CAAC,CAAC"}

package/dist/compose.d.ts

@@ -0,0 +1,47 @@
+import { type EnforcementLevel, type KebabToCamel, type Mark, type Value } from '@cratylus/schema';
+import { type Agent, type Dimension, MANIFEST } from './manifest.js';
+/** The factors an agent holds a field for: every factor that is not an attribute. */
+type HeldFactor = {
+    [D in Dimension]: (typeof MANIFEST)[D]['arity'] extends 'attribute' ? never : D;
+}[Dimension];
+/** The field a held factor occupies on a role cell and a composed agent. */
+export type FactorField = KebabToCamel<HeldFactor>;
+/** A value as a role or persona states it: bare, or with its level, slot or note. */
+export type Stated<D extends string = string> = Value<D> | {
+    readonly value: Value<D>;
+    readonly level?: EnforcementLevel | null;
+    readonly slot?: string;
+    readonly note?: string;
+};
+/** A role: its full default vector, every non-attribute factor stated. */
+export interface RoleCell {
+    /** The role's anchor; the generic holder's name. */
+    readonly name: string;
+    readonly description: string;
+    /** Roles carry no mark (the master design gives none). */
+    readonly mark: Mark | null;
+    readonly values: {
+        readonly [D in HeldFactor as KebabToCamel<D>]: readonly Stated<D>[];
+    };
+}
+/** A persona: what it states over its role, by field; everything else is the role's. */
+export interface Residue {
+    readonly name: string;
+    readonly description: string;
+    readonly mark: Mark;
+    readonly values?: {
+        readonly [field: string]: readonly Stated[];
+    };
+    readonly removes?: {
+        readonly [field: string]: readonly Value<string>[];
+    };
+}
+/** A composition the design forbids; the message names what was refused. */
+export declare class CompositionRefusal extends Error {
+    readonly name = "CompositionRefusal";
+}
+/** The generic holder of a role: the role's vector, named for the role. */
+export declare function holder(cell: RoleCell): Agent;
+/** A persona over a role: the role's vector, then the residue's precedence. */
+export declare function persona(over: RoleCell, residue: Residue): Agent;
+export {};