@cratylus/canon 0.12.4 → 0.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/README.md +47 -27
  2. package/dist/agents/architect.js +4 -16
  3. package/dist/agents/architect.js.map +1 -1
  4. package/dist/agents/assayer.js +4 -21
  5. package/dist/agents/assayer.js.map +1 -1
  6. package/dist/agents/implementer.js +4 -15
  7. package/dist/agents/implementer.js.map +1 -1
  8. package/dist/agents/integrator.js +4 -18
  9. package/dist/agents/integrator.js.map +1 -1
  10. package/dist/agents/kino.js +5 -5
  11. package/dist/agents/kino.js.map +1 -1
  12. package/dist/agents/mav.js +13 -14
  13. package/dist/agents/mav.js.map +1 -1
  14. package/dist/agents/nico.js +0 -1
  15. package/dist/agents/nico.js.map +1 -1
  16. package/dist/agents/planner.js +4 -10
  17. package/dist/agents/planner.js.map +1 -1
  18. package/dist/dimensions/role/architect.js +1 -1
  19. package/dist/dimensions/role/architect.js.map +1 -1
  20. package/dist/dimensions/role/implementer.js +4 -4
  21. package/dist/dimensions/role/implementer.js.map +1 -1
  22. package/dist/dimensions/role/integrator.js +3 -3
  23. package/dist/dimensions/role/integrator.js.map +1 -1
  24. package/dist/hooks/purview-guardrail.js +1 -1
  25. package/dist/hooks/purview-guardrail.js.map +1 -1
  26. package/dist/index.js +6 -0
  27. package/dist/index.js.map +1 -1
  28. package/dist/practices.d.ts +9 -0
  29. package/dist/practices.js +70 -0
  30. package/dist/practices.js.map +1 -0
  31. package/dist/roles/architect.js +23 -5
  32. package/dist/roles/architect.js.map +1 -1
  33. package/dist/roles/assayer.js +23 -1
  34. package/dist/roles/assayer.js.map +1 -1
  35. package/dist/roles/hold.d.ts +44 -14
  36. package/dist/roles/hold.js +46 -36
  37. package/dist/roles/hold.js.map +1 -1
  38. package/dist/roles/implementer.js +19 -4
  39. package/dist/roles/implementer.js.map +1 -1
  40. package/dist/roles/integrator.js +21 -3
  41. package/dist/roles/integrator.js.map +1 -1
  42. package/dist/roles/planner.js +14 -4
  43. package/dist/roles/planner.js.map +1 -1
  44. package/dist/rules/repo-preamble.js +1 -1
  45. package/package.json +4 -4
@@ -25,17 +25,27 @@ import { provenanceAttribution as provenanceAttribution_transparency } from '../
25
25
  // shards were cut above it, and the contract's `⊄ writes C` is what makes that
26
26
  // refusal structural rather than a matter of discipline.
27
27
  //
28
- // `system-design` is absent alongside `software-engineering` — this position neither
28
+ // `system-design` is absent alongside `software-engineering` — this role neither
29
29
  // designs nor builds. What it owns is the plan: the census, the units cut from the
30
30
  // shards it is handed, and the plan's records from binding, which cuts the plan's line, to
31
- // closing. The integrator, not this position, commits the records it writes on the line.
31
+ // closing. The integrator, not this role, commits the records it writes on the line.
32
+ //
33
+ // THE GENERIC HOLDER is `planner`, and it declares nothing: the census, the cut into units,
34
+ // the refusal to redraw a shard, the waves and the plan's records are all facts about the
35
+ // ROLE, and a persona over a different domain would declare its domain and inherit every
36
+ // one of them.
32
37
  export const plannerRole = {
33
38
  sign: planner_role,
39
+ description: 'Use this agent to plan the shards the architect hands down — one unit per shard, dependencies first, each sized for one implementer: run the census of what exists and what references what, slice on the design’s seams, declare each unit’s real footprint and mechanical acceptance criteria, and order the units into waves with disjoint outputs, deciding how each shard is realized on each harness. It owns the plan: binds it when none is bound (the bind cuts the plan’s line, where every record about the plan is then written), records each unit’s state as its name is handed out and as it completes, closes it, re-plans (rectify or rebuild) when a shard it builds on is found wrong, and reconciles plans and units. Returns only the plan’s name and the ready units’ names. Surfaces a shard it cannot plan rather than redrawing it, and never changes the design.',
40
+ archetype: "Draftsman of the work — takes the shards someone else cut and produces the working drawings inside them, and the plan that holds those drawings. Its characteristic defect is the under-declared footprint: a unit's blast radius read off where a name is DEFINED while the work is bounded by where it is USED, which silently voids every disjointness proof the waves rest on. So it resolves by usage before declaring outputs, and treats every count it writes as a measurement with a timestamp rather than a fact. It owns the plan end to end (binding, which cuts the plan's line, state, closing, reconciling) and re-plans when a shard is found wrong, but never moves a shard it was given and never changes the design; a shard that will not plan is surfaced upward intact, and what it returns is names alone.",
41
+ provenance: { mark: { emoji: '🗺️', hue: 'yellow' } },
34
42
  // The role declares one skill, `plan`, and is given plan's composition with it
35
43
  // (`design`, `note`), so it reads the shards it plans. `deliver` belongs to the rung
36
44
  // ABOVE, which cuts them; the rung BELOW declares none at all, because an
37
45
  // implementer's decisions are made for it by its spec.
38
46
  skills: ['plan'],
47
+ // Dispatches no role: it plans what it is handed and returns names.
48
+ dispatches: [],
39
49
  vector: {
40
50
  formality: plain_formality,
41
51
  audienceAdaptation: maintenance_audienceAdaptation,
@@ -45,7 +55,7 @@ export const plannerRole = {
45
55
  // inferred.
46
56
  transparency: provenanceAttribution_transparency,
47
57
  autonomy: [missionCommand, handoff_autonomy],
48
- // `thoroughness`, not `delivery`: this position ships no artifact a user sees, and
58
+ // `thoroughness`, not `delivery`: this role ships no artifact a user sees, and
49
59
  // its failure mode is an incomplete census rather than a slow one.
50
60
  objective: thoroughness_objective,
51
61
  engineeringPrinciples: [
@@ -62,7 +72,7 @@ export const plannerRole = {
62
72
  researchInvestigation_capabilities,
63
73
  ],
64
74
  learning: correctionConsolidation_learning,
65
- // `comprehension`, where the architect holds `projection`: this position's job is
75
+ // `comprehension`, where the architect holds `projection`: this role's job is
66
76
  // to establish what IS, exhaustively, not to anticipate what follows.
67
77
  situationAwareness: comprehension_situationAwareness,
68
78
  framing: decompositional_framing,
@@ -1 +1 @@
1
- {"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/roles/planner.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/roles/planner.ts"],"names":[],"mappings":"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"}
@@ -24,7 +24,7 @@ export const repoPreamble = {
24
24
  refs: [],
25
25
  content: `# AGENTS
26
26
 
27
- **CRITICAL INVARIENT:** You **MUST Read** these documents upon session-start:\\*\\*
27
+ **CRITICAL INVARIANT:** You **MUST Read** these documents upon session-start:
28
28
 
29
29
  - [\`CANON.md\`](./CANON.md) — **overview and primer**
30
30
  - [\`CRATYLISM\`](./packages/canon/src/dimensions/engineering-principles/cratylism.ts) — The First Principle (**LOCKED**)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cratylus/canon",
3
- "version": "0.12.4",
3
+ "version": "0.13.1",
4
4
  "description": "The canonical corpus of discovered optimal-signifiers — agents, skills, dimensions and rules as typed TS source. Markdown is a projection of these modules.",
5
5
  "license": "MIT",
6
6
  "engines": {
@@ -18,11 +18,11 @@
18
18
  ],
19
19
  "//test": "`test` builds FIRST because `test/runtime-shim.test.ts` drives the shipped `cratylus project` over the repository's own `cratylus.config.ts`, and that config extends `@cratylus/canon` — the PACKAGE, i.e. this package's `dist`. turbo's `test.dependsOn: [^build]` builds this package's DEPENDENCIES, never this package, so a cold clone would run the consumer path against a dist that does not exist.",
20
20
  "dependencies": {
21
- "@cratylus/schema": "0.7.0"
21
+ "@cratylus/schema": "0.8.1"
22
22
  },
23
23
  "devDependencies": {
24
- "@cratylus/forge": "0.13.0",
25
- "@cratylus/runtime": "0.9.0",
24
+ "@cratylus/forge": "0.14.1",
25
+ "@cratylus/runtime": "0.9.2",
26
26
  "@cratylus/tooling": "0.0.0",
27
27
  "@types/node": "^22.0.0",
28
28
  "tsx": "^4.19.0",