@shardworks/astrolabe-apparatus 0.1.188 → 0.1.189
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.
- package/README.md +1 -13
- package/dist/astrolabe.d.ts.map +1 -1
- package/dist/astrolabe.js +0 -4
- package/dist/astrolabe.js.map +1 -1
- package/package.json +8 -8
- package/dist/planning-ssr.d.ts +0 -24
- package/dist/planning-ssr.d.ts.map +0 -1
- package/dist/planning-ssr.js +0 -141
- package/dist/planning-ssr.js.map +0 -1
package/README.md
CHANGED
|
@@ -142,7 +142,6 @@ The Astrolabe declares one book in Stacks:
|
|
|
142
142
|
| Name | Description |
|
|
143
143
|
|---|---|
|
|
144
144
|
| `brief` | A patron brief triggering the planning pipeline |
|
|
145
|
-
| `brief-ssr` | A patron brief triggering the single-shot reader planning pipeline (experimental) |
|
|
146
145
|
| `brief-mra` | Experimental brief using merged reader/analyst pipeline |
|
|
147
146
|
|
|
148
147
|
### Roles (contributed to Loom)
|
|
@@ -164,20 +163,9 @@ The Astrolabe declares one book in Stacks:
|
|
|
164
163
|
| Template | Mapped Writ Type | Engines |
|
|
165
164
|
|---|---|---|
|
|
166
165
|
| `astrolabe.planning` | `brief` | plan-init → draft → reader → inventory-check → analyst → decision-review → spec-writer → spec-publish → seal |
|
|
167
|
-
| `astrolabe.planning-ssr` | `brief-ssr` | Same pipeline as `planning`; reader engine uses a single-shot prompt (experimental) |
|
|
168
166
|
| `astrolabe.planning-mra` | `brief-mra` | plan-init → draft → reader-analyst → inventory-check → decision-review → spec-writer → spec-publish → seal |
|
|
169
167
|
|
|
170
|
-
The `resolutionEngine` is `spec-writer` for
|
|
171
|
-
|
|
172
|
-
#### `planning-ssr` (experimental)
|
|
173
|
-
|
|
174
|
-
The `planning-ssr` template is an A/B experiment testing whether the reader stage can produce its inventory in 1–2 turns instead of ~25. The only difference from `planning` is the reader engine's prompt, which instructs the agent to batch all filesystem exploration into parallel tool calls and produce the inventory immediately. All other engines, wiring, and givens are identical. The reader engine retains `engineId: 'reader'` so session profiling is directly comparable between control and experiment.
|
|
175
|
-
|
|
176
|
-
Post a `brief-ssr` writ to route through this template:
|
|
177
|
-
|
|
178
|
-
```
|
|
179
|
-
nsg commission-post --type brief-ssr --title "..." --body "..."
|
|
180
|
-
```
|
|
168
|
+
The `resolutionEngine` is `spec-writer` for both templates — the rig's completion summary comes from the specification writer session.
|
|
181
169
|
|
|
182
170
|
#### `planning-mra` (experimental)
|
|
183
171
|
|
package/dist/astrolabe.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"astrolabe.d.ts","sourceRoot":"","sources":["../src/astrolabe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,wBAAwB,CAAC;AAQrE,OAAO,KAAK,EAEV,eAAe,EAGhB,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"astrolabe.d.ts","sourceRoot":"","sources":["../src/astrolabe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAkB,MAAM,wBAAwB,CAAC;AAQrE,OAAO,KAAK,EAEV,eAAe,EAGhB,MAAM,YAAY,CAAC;AAqBpB,iBAAS,sBAAsB,IAAI,eAAe,CAEjD;AAmGD,wBAAgB,eAAe,IAAI,MAAM,CAkQxC;AAGD,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
|
package/dist/astrolabe.js
CHANGED
|
@@ -18,7 +18,6 @@ const decisionAnalysisSchema = z.object({
|
|
|
18
18
|
stakes: z.enum(['low', 'high']).optional(),
|
|
19
19
|
});
|
|
20
20
|
import { createPlanInitEngine, createInventoryCheckEngine, createDecisionReviewEngine, createSpecPublishEngine, } from "./engines/index.js";
|
|
21
|
-
import { planningSsrTemplate } from "./planning-ssr.js";
|
|
22
21
|
import { planningMraTemplate } from "./planning-mra.js";
|
|
23
22
|
// ── Config resolver ──────────────────────────────────────────────────
|
|
24
23
|
function resolveAstrolabeConfig() {
|
|
@@ -297,7 +296,6 @@ export function createAstrolabe() {
|
|
|
297
296
|
},
|
|
298
297
|
writTypes: [
|
|
299
298
|
{ name: 'brief', description: 'A patron brief triggering the planning pipeline' },
|
|
300
|
-
{ name: 'brief-ssr', description: 'A patron brief triggering the single-shot reader planning pipeline (experimental)' },
|
|
301
299
|
{ name: 'brief-mra', description: 'Experimental brief using merged reader/analyst pipeline' },
|
|
302
300
|
],
|
|
303
301
|
roles: {
|
|
@@ -315,12 +313,10 @@ export function createAstrolabe() {
|
|
|
315
313
|
},
|
|
316
314
|
rigTemplates: {
|
|
317
315
|
planning: planningTemplate,
|
|
318
|
-
'planning-ssr': planningSsrTemplate,
|
|
319
316
|
'planning-mra': planningMraTemplate,
|
|
320
317
|
},
|
|
321
318
|
rigTemplateMappings: {
|
|
322
319
|
brief: 'astrolabe.planning',
|
|
323
|
-
'brief-ssr': 'astrolabe.planning-ssr',
|
|
324
320
|
'brief-mra': 'astrolabe.planning-mra',
|
|
325
321
|
},
|
|
326
322
|
tools: [
|
package/dist/astrolabe.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"astrolabe.js","sourceRoot":"","sources":["../src/astrolabe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAInD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,oFAAoF;AACpF,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAEH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"astrolabe.js","sourceRoot":"","sources":["../src/astrolabe.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shardworks/astrolabe-apparatus",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.189",
|
|
4
4
|
"license": "ISC",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -20,16 +20,16 @@
|
|
|
20
20
|
},
|
|
21
21
|
"dependencies": {
|
|
22
22
|
"zod": "4.3.6",
|
|
23
|
-
"@shardworks/stacks-apparatus": "0.1.
|
|
24
|
-
"@shardworks/tools-apparatus": "0.1.
|
|
25
|
-
"@shardworks/
|
|
26
|
-
"@shardworks/clerk-apparatus": "0.1.
|
|
27
|
-
"@shardworks/loom-apparatus": "0.1.
|
|
28
|
-
"@shardworks/
|
|
23
|
+
"@shardworks/stacks-apparatus": "0.1.189",
|
|
24
|
+
"@shardworks/tools-apparatus": "0.1.189",
|
|
25
|
+
"@shardworks/spider-apparatus": "0.1.189",
|
|
26
|
+
"@shardworks/clerk-apparatus": "0.1.189",
|
|
27
|
+
"@shardworks/loom-apparatus": "0.1.189",
|
|
28
|
+
"@shardworks/fabricator-apparatus": "0.1.189"
|
|
29
29
|
},
|
|
30
30
|
"devDependencies": {
|
|
31
31
|
"@types/node": "25.5.0",
|
|
32
|
-
"@shardworks/nexus-core": "0.1.
|
|
32
|
+
"@shardworks/nexus-core": "0.1.189"
|
|
33
33
|
},
|
|
34
34
|
"files": [
|
|
35
35
|
"dist",
|
package/dist/planning-ssr.d.ts
DELETED
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* planning-ssr — Single-Shot Reader experimental rig template.
|
|
3
|
-
*
|
|
4
|
-
* Identical stage pipeline to `planning` (plan-init → draft → reader →
|
|
5
|
-
* inventory-check → analyst → decision-review → spec-writer → spec-publish
|
|
6
|
-
* → seal) with only the `reader` engine's prompt changed.
|
|
7
|
-
*
|
|
8
|
-
* The hypothesis: reader can produce the codebase inventory in 1–2 turns
|
|
9
|
-
* (max 3) instead of ~25, cutting reader cost by ~10–20×.
|
|
10
|
-
*
|
|
11
|
-
* The prompt instructs the agent to:
|
|
12
|
-
* 1. Batch all initial orientation (Glob/Read) into a single parallel
|
|
13
|
-
* tool-call round.
|
|
14
|
-
* 2. Produce and write the full inventory via inventory-write immediately
|
|
15
|
-
* after that orientation round.
|
|
16
|
-
* 3. Use at most one optional follow-up turn for targeted clarification
|
|
17
|
-
* before finalizing.
|
|
18
|
-
*
|
|
19
|
-
* Engine ID remains 'reader' so profiling sessions are directly comparable
|
|
20
|
-
* between control (planning) and experiment (planning-ssr).
|
|
21
|
-
*/
|
|
22
|
-
import type { RigTemplate } from '@shardworks/spider-apparatus';
|
|
23
|
-
export declare const planningSsrTemplate: RigTemplate;
|
|
24
|
-
//# sourceMappingURL=planning-ssr.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"planning-ssr.d.ts","sourceRoot":"","sources":["../src/planning-ssr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAqChE,eAAO,MAAM,mBAAmB,EAAE,WAwFjC,CAAC"}
|
package/dist/planning-ssr.js
DELETED
|
@@ -1,141 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* planning-ssr — Single-Shot Reader experimental rig template.
|
|
3
|
-
*
|
|
4
|
-
* Identical stage pipeline to `planning` (plan-init → draft → reader →
|
|
5
|
-
* inventory-check → analyst → decision-review → spec-writer → spec-publish
|
|
6
|
-
* → seal) with only the `reader` engine's prompt changed.
|
|
7
|
-
*
|
|
8
|
-
* The hypothesis: reader can produce the codebase inventory in 1–2 turns
|
|
9
|
-
* (max 3) instead of ~25, cutting reader cost by ~10–20×.
|
|
10
|
-
*
|
|
11
|
-
* The prompt instructs the agent to:
|
|
12
|
-
* 1. Batch all initial orientation (Glob/Read) into a single parallel
|
|
13
|
-
* tool-call round.
|
|
14
|
-
* 2. Produce and write the full inventory via inventory-write immediately
|
|
15
|
-
* after that orientation round.
|
|
16
|
-
* 3. Use at most one optional follow-up turn for targeted clarification
|
|
17
|
-
* before finalizing.
|
|
18
|
-
*
|
|
19
|
-
* Engine ID remains 'reader' so profiling sessions are directly comparable
|
|
20
|
-
* between control (planning) and experiment (planning-ssr).
|
|
21
|
-
*/
|
|
22
|
-
// ── Single-shot reader prompt ───────────────────────────────────────
|
|
23
|
-
const singleShotReaderPrompt = `MODE: READER
|
|
24
|
-
|
|
25
|
-
Plan ID: \${yields.plan-init.planId}
|
|
26
|
-
|
|
27
|
-
You are beginning a new planning session. Your goal is to produce a complete codebase inventory in a SINGLE response — do not explore iteratively turn-by-turn.
|
|
28
|
-
|
|
29
|
-
## Process
|
|
30
|
-
|
|
31
|
-
1. **Orientation (this turn).** Call plan-show to read the plan, then immediately issue a BATCH of parallel tool calls to orient yourself:
|
|
32
|
-
- Use Glob to discover the full directory tree and file layout relevant to the brief.
|
|
33
|
-
- Use Read to load key files you can identify from the plan's codex and brief description (entry points, types, tests, config, README).
|
|
34
|
-
- Use Grep to locate symbols, patterns, or conventions mentioned in the brief.
|
|
35
|
-
Issue ALL of these tool calls together in a single parallel batch — do not wait for results before issuing more reads.
|
|
36
|
-
|
|
37
|
-
2. **Inventory (this turn or next).** Once you have the orientation results, produce the complete structured inventory and write it using inventory-write. The inventory must contain:
|
|
38
|
-
- **Affected code:** every file that will likely be created, modified, or deleted; every type/interface involved (copy actual signatures); every function that will change; every test file for affected code.
|
|
39
|
-
- **Adjacent patterns:** how sibling features handle the same problem (2-3 comparable implementations if they exist); codebase conventions for this kind of change.
|
|
40
|
-
- **Existing context:** scratch notes, TODOs, prior commissions, known-gaps entries.
|
|
41
|
-
- **Doc/code discrepancies:** places where docs describe different behavior than code implements.
|
|
42
|
-
|
|
43
|
-
This is a working document — rough, exhaustive, and unpolished. Value completeness over formatting.
|
|
44
|
-
|
|
45
|
-
3. **Optional clarification (at most 1 follow-up turn).** If and only if the orientation round reveals that critical files were missed — files you now know exist but did not read — you may issue ONE more batch of targeted reads, then immediately update the inventory via inventory-write.
|
|
46
|
-
|
|
47
|
-
## Constraints
|
|
48
|
-
|
|
49
|
-
- **Maximum 3 turns total** (orientation + inventory + optional clarification). You MUST write the inventory and exit within this budget.
|
|
50
|
-
- **Parallel tool calls.** Always batch your Read/Glob/Grep calls into a single parallel request. Never issue them one-at-a-time across turns.
|
|
51
|
-
- **No analysis.** You read and record. You do not analyze, design, or make decisions.
|
|
52
|
-
- **Write early.** If in doubt whether you need a clarification turn, write the inventory with what you have. An imperfect inventory written in 2 turns is better than a perfect one written in 25.`;
|
|
53
|
-
// ── Template ────────────────────────────────────────────────────────
|
|
54
|
-
export const planningSsrTemplate = {
|
|
55
|
-
engines: [
|
|
56
|
-
{
|
|
57
|
-
id: 'plan-init',
|
|
58
|
-
designId: 'astrolabe.plan-init',
|
|
59
|
-
upstream: [],
|
|
60
|
-
givens: { writ: '${writ}' },
|
|
61
|
-
},
|
|
62
|
-
{
|
|
63
|
-
id: 'draft',
|
|
64
|
-
designId: 'draft',
|
|
65
|
-
upstream: ['plan-init'],
|
|
66
|
-
givens: { writ: '${writ}' },
|
|
67
|
-
},
|
|
68
|
-
{
|
|
69
|
-
id: 'reader',
|
|
70
|
-
designId: 'anima-session',
|
|
71
|
-
upstream: ['draft'],
|
|
72
|
-
givens: {
|
|
73
|
-
role: 'astrolabe.sage',
|
|
74
|
-
prompt: singleShotReaderPrompt,
|
|
75
|
-
cwd: '${yields.draft.path}',
|
|
76
|
-
writ: '${writ}',
|
|
77
|
-
},
|
|
78
|
-
},
|
|
79
|
-
{
|
|
80
|
-
id: 'inventory-check',
|
|
81
|
-
designId: 'astrolabe.inventory-check',
|
|
82
|
-
upstream: ['reader'],
|
|
83
|
-
givens: {
|
|
84
|
-
planId: '${yields.plan-init.planId}',
|
|
85
|
-
},
|
|
86
|
-
},
|
|
87
|
-
{
|
|
88
|
-
id: 'analyst',
|
|
89
|
-
designId: 'anima-session',
|
|
90
|
-
upstream: ['inventory-check'],
|
|
91
|
-
givens: {
|
|
92
|
-
role: 'astrolabe.sage',
|
|
93
|
-
prompt: 'MODE: ANALYST\n\nPlan ID: ${yields.plan-init.planId}\n\n' +
|
|
94
|
-
'You are continuing the reader conversation. Use plan-show to read the current ' +
|
|
95
|
-
'plan state, then produce scope, decisions, and observations using the write tools.',
|
|
96
|
-
cwd: '${yields.draft.path}',
|
|
97
|
-
conversationId: '${yields.reader.conversationId}',
|
|
98
|
-
writ: '${writ}',
|
|
99
|
-
},
|
|
100
|
-
},
|
|
101
|
-
{
|
|
102
|
-
id: 'decision-review',
|
|
103
|
-
designId: 'astrolabe.decision-review',
|
|
104
|
-
upstream: ['analyst'],
|
|
105
|
-
givens: {
|
|
106
|
-
planId: '${yields.plan-init.planId}',
|
|
107
|
-
},
|
|
108
|
-
},
|
|
109
|
-
{
|
|
110
|
-
id: 'spec-writer',
|
|
111
|
-
designId: 'anima-session',
|
|
112
|
-
upstream: ['decision-review'],
|
|
113
|
-
givens: {
|
|
114
|
-
role: 'astrolabe.sage',
|
|
115
|
-
prompt: 'MODE: WRITER\n\nPlan ID: ${yields.plan-init.planId}\n\n' +
|
|
116
|
-
'You are continuing the analyst conversation. Use plan-show to read the full ' +
|
|
117
|
-
'plan including patron-reviewed decisions, then write the specification using spec-write.' +
|
|
118
|
-
'\n\nDecision summary:\n${yields.decision-review.decisionSummary}',
|
|
119
|
-
cwd: '${yields.draft.path}',
|
|
120
|
-
conversationId: '${yields.analyst.conversationId}',
|
|
121
|
-
writ: '${writ}',
|
|
122
|
-
},
|
|
123
|
-
},
|
|
124
|
-
{
|
|
125
|
-
id: 'spec-publish',
|
|
126
|
-
designId: 'astrolabe.spec-publish',
|
|
127
|
-
upstream: ['spec-writer'],
|
|
128
|
-
givens: {
|
|
129
|
-
planId: '${yields.plan-init.planId}',
|
|
130
|
-
},
|
|
131
|
-
},
|
|
132
|
-
{
|
|
133
|
-
id: 'seal',
|
|
134
|
-
designId: 'seal',
|
|
135
|
-
upstream: ['spec-publish'],
|
|
136
|
-
givens: { abandon: true },
|
|
137
|
-
},
|
|
138
|
-
],
|
|
139
|
-
resolutionEngine: 'spec-writer',
|
|
140
|
-
};
|
|
141
|
-
//# sourceMappingURL=planning-ssr.js.map
|
package/dist/planning-ssr.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"planning-ssr.js","sourceRoot":"","sources":["../src/planning-ssr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,uEAAuE;AAEvE,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oMA6BqK,CAAC;AAErM,uEAAuE;AAEvE,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,OAAO,EAAE;QACP;YACE,EAAE,EAAE,WAAW;YACf,QAAQ,EAAE,qBAAqB;YAC/B,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC5B;QACD;YACE,EAAE,EAAE,OAAO;YACX,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,CAAC,WAAW,CAAC;YACvB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC5B;QACD;YACE,EAAE,EAAE,QAAQ;YACZ,QAAQ,EAAE,eAAe;YACzB,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,MAAM,EAAE;gBACN,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,sBAAsB;gBAC9B,GAAG,EAAE,sBAAsB;gBAC3B,IAAI,EAAE,SAAS;aAChB;SACF;QACD;YACE,EAAE,EAAE,iBAAiB;YACrB,QAAQ,EAAE,2BAA2B;YACrC,QAAQ,EAAE,CAAC,QAAQ,CAAC;YACpB,MAAM,EAAE;gBACN,MAAM,EAAE,4BAA4B;aACrC;SACF;QACD;YACE,EAAE,EAAE,SAAS;YACb,QAAQ,EAAE,eAAe;YACzB,QAAQ,EAAE,CAAC,iBAAiB,CAAC;YAC7B,MAAM,EAAE;gBACN,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EACJ,0DAA0D;oBAC1D,gFAAgF;oBAChF,oFAAoF;gBACtF,GAAG,EAAE,sBAAsB;gBAC3B,cAAc,EAAE,iCAAiC;gBACjD,IAAI,EAAE,SAAS;aAChB;SACF;QACD;YACE,EAAE,EAAE,iBAAiB;YACrB,QAAQ,EAAE,2BAA2B;YACrC,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,MAAM,EAAE;gBACN,MAAM,EAAE,4BAA4B;aACrC;SACF;QACD;YACE,EAAE,EAAE,aAAa;YACjB,QAAQ,EAAE,eAAe;YACzB,QAAQ,EAAE,CAAC,iBAAiB,CAAC;YAC7B,MAAM,EAAE;gBACN,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EACJ,yDAAyD;oBACzD,8EAA8E;oBAC9E,0FAA0F;oBAC1F,kEAAkE;gBACpE,GAAG,EAAE,sBAAsB;gBAC3B,cAAc,EAAE,kCAAkC;gBAClD,IAAI,EAAE,SAAS;aAChB;SACF;QACD;YACE,EAAE,EAAE,cAAc;YAClB,QAAQ,EAAE,wBAAwB;YAClC,QAAQ,EAAE,CAAC,aAAa,CAAC;YACzB,MAAM,EAAE;gBACN,MAAM,EAAE,4BAA4B;aACrC;SACF;QACD;YACE,EAAE,EAAE,MAAM;YACV,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,CAAC,cAAc,CAAC;YAC1B,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;SAC1B;KACF;IACD,gBAAgB,EAAE,aAAa;CAChC,CAAC"}
|