Skip to content

Commit d4e679f

Browse files
DKFuHDKFuH
committed
chore(release): prepare v0.9.1 metadata
1 parent 08fcd2f commit d4e679f

19 files changed

+406
-318
lines changed

‎CHANGELOG.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,16 @@ The format is based on Keep a Changelog, and this project follows Semantic Versi
66

77
## [Unreleased]
88

9+
## [0.9.1] - 2026-03-30
10+
911
- Added safe whole-line `#` comments for human-readable notes on supported blocks and statement lines.
1012
- Added allowlisted structured annotations via `@key "value"` with AST and canonical-model support.
1113
- Added lint protection for suspicious business-logic-like comments to keep comments non-authoritative.
1214
- Updated the formatter, diagnostics, specs, editor grammar, and tests for comments and annotations.
15+
- Added optional annotation rendering for Markdown and HTML export via `--with-annotations`.
16+
- Added an explicit annotation metadata block to `export context` for AI and tooling consumers.
17+
- Added VS Code snippets plus small language-configuration improvements for comments and annotations.
18+
- Rewrote the DE/EN handbooks on the current language and tooling surface and removed legacy `.docx` artifacts.
1319

1420
## [0.9.0-rc1] - 2026-03-29
1521

‎docs/demos/html/craft-business-lead-to-order.html‎

Lines changed: 87 additions & 94 deletions
Original file line numberDiff line numberDiff line change
@@ -95,23 +95,12 @@
9595
ul {
9696
padding-left: 1.5rem;
9797
}
98-
.status-bar {
99-
display: flex;
100-
gap: 1rem;
101-
margin-top: 1rem;
102-
font-size: 0.875rem;
103-
}
104-
.tag {
105-
background: #e2e8f0;
106-
padding: 0.2rem 0.6rem;
107-
border-radius: 999px;
108-
}
10998
</style>
11099
</head>
111100
<body>
112101
<header>
113102
<h1>OrgScript Demo: Craft Business: Lead to Order</h1>
114-
<p>Generated by OrgScript v0.6.0</p>
103+
<p>Generated by OrgScript</p>
115104
</header>
116105

117106
<nav>
@@ -131,72 +120,73 @@ <h2>Table of Contents</h2>
131120
<h2>CraftBusinessLeadToOrder</h2>
132121
<div class="summary-container">
133122

123+
134124
<p><strong>Triggered by:</strong> <code>lead.created</code></p>
135125
<p>Orchestrates business logic and state transitions for the <code>CraftBusinessLeadToOrder</code> process.</p>
136126

137127
</div>
138128
<div class="visual-container"><h3>Diagram</h3><pre class="mermaid">flowchart TD
139-
p1_start_1(["CraftBusinessLeadToOrder"])
129+
p1_start_1([&quot;CraftBusinessLeadToOrder&quot;])
140130
class p1_start_1 success
141-
p1_trigger_2[/ "when lead.created" /]
131+
p1_trigger_2[/ &quot;when lead.created&quot; /]
142132
class p1_trigger_2 trigger
143-
p1_decision_3{"if lead.source = 'referral'"}
133+
p1_decision_3{&quot;if lead.source = &#39;referral&#39;&quot;}
144134
class p1_decision_3 decision
145-
p1_action_4["assign lead.priority = 'high'"]
135+
p1_action_4[&quot;assign lead.priority = &#39;high&#39;&quot;]
146136
class p1_action_4 action
147-
p1_action_5["assign lead.sales_path = 'premium'"]
137+
p1_action_5[&quot;assign lead.sales_path = &#39;premium&#39;&quot;]
148138
class p1_action_5 action
149-
p1_action_6["notify sales with #quot;Handle referral lead first#quot;"]
139+
p1_action_6[&quot;notify sales with #quot;Handle referral lead first#quot;&quot;]
150140
class p1_action_6 action
151-
p1_decision_7{"if lead.source = 'aroundhome'"}
141+
p1_decision_7{&quot;if lead.source = &#39;aroundhome&#39;&quot;}
152142
class p1_decision_7 decision
153-
p1_action_8["assign lead.priority = 'low'"]
143+
p1_action_8[&quot;assign lead.priority = &#39;low&#39;&quot;]
154144
class p1_action_8 action
155-
p1_action_9["assign lead.sales_path = 'standard'"]
145+
p1_action_9[&quot;assign lead.sales_path = &#39;standard&#39;&quot;]
156146
class p1_action_9 action
157-
p1_decision_10{"if lead.project_type != 'kitchen' and lead.project_type != 'interior'"}
147+
p1_decision_10{&quot;if lead.project_type != &#39;kitchen&#39; and lead.project_type != &#39;interior&#39;&quot;}
158148
class p1_decision_10 decision
159-
p1_action_11["transition lead.status to 'disqualified'"]
149+
p1_action_11[&quot;transition lead.status to &#39;disqualified&#39;&quot;]
160150
class p1_action_11 action
161-
p1_action_12["notify sales with #quot;Outside target project type#quot;"]
151+
p1_action_12[&quot;notify sales with #quot;Outside target project type#quot;&quot;]
162152
class p1_action_12 action
163-
p1_stop_13(["stop"])
153+
p1_stop_13([&quot;stop&quot;])
164154
class p1_stop_13 stop
165-
p1_decision_14{"if lead.estimated_value < 10000"}
155+
p1_decision_14{&quot;if lead.estimated_value &lt; 10000&quot;}
166156
class p1_decision_14 decision
167-
p1_action_15["transition lead.status to 'disqualified'"]
157+
p1_action_15[&quot;transition lead.status to &#39;disqualified&#39;&quot;]
168158
class p1_action_15 action
169-
p1_action_16["notify sales with #quot;Below minimum project value#quot;"]
159+
p1_action_16[&quot;notify sales with #quot;Below minimum project value#quot;&quot;]
170160
class p1_action_16 action
171-
p1_stop_17(["stop"])
161+
p1_stop_17([&quot;stop&quot;])
172162
class p1_stop_17 stop
173-
p1_action_18["transition lead.status to 'qualified'"]
163+
p1_action_18[&quot;transition lead.status to &#39;qualified&#39;&quot;]
174164
class p1_action_18 action
175-
p1_action_19["assign lead.owner = 'sales'"]
165+
p1_action_19[&quot;assign lead.owner = &#39;sales&#39;&quot;]
176166
class p1_action_19 action
177-
p1_end_20(["done"])
167+
p1_end_20([&quot;done&quot;])
178168
class p1_end_20 success
179-
p1_start_1 --> p1_trigger_2
180-
p1_trigger_2 --> p1_decision_3
181-
p1_decision_3 -->|yes| p1_action_4
182-
p1_action_4 --> p1_action_5
183-
p1_action_5 --> p1_action_6
184-
p1_decision_3 -->|no| p1_decision_7
185-
p1_decision_7 -->|yes| p1_action_8
186-
p1_action_8 --> p1_action_9
187-
p1_action_6 --> p1_decision_10
188-
p1_action_9 --> p1_decision_10
189-
p1_decision_7 -->|no| p1_decision_10
190-
p1_decision_10 -->|yes| p1_action_11
191-
p1_action_11 --> p1_action_12
192-
p1_action_12 --> p1_stop_13
193-
p1_decision_10 -->|no| p1_decision_14
194-
p1_decision_14 -->|yes| p1_action_15
195-
p1_action_15 --> p1_action_16
196-
p1_action_16 --> p1_stop_17
197-
p1_decision_14 -->|no| p1_action_18
198-
p1_action_18 --> p1_action_19
199-
p1_action_19 --> p1_end_20
169+
p1_start_1 --&gt; p1_trigger_2
170+
p1_trigger_2 --&gt; p1_decision_3
171+
p1_decision_3 --&gt;|yes| p1_action_4
172+
p1_action_4 --&gt; p1_action_5
173+
p1_action_5 --&gt; p1_action_6
174+
p1_decision_3 --&gt;|no| p1_decision_7
175+
p1_decision_7 --&gt;|yes| p1_action_8
176+
p1_action_8 --&gt; p1_action_9
177+
p1_action_6 --&gt; p1_decision_10
178+
p1_action_9 --&gt; p1_decision_10
179+
p1_decision_7 --&gt;|no| p1_decision_10
180+
p1_decision_10 --&gt;|yes| p1_action_11
181+
p1_action_11 --&gt; p1_action_12
182+
p1_action_12 --&gt; p1_stop_13
183+
p1_decision_10 --&gt;|no| p1_decision_14
184+
p1_decision_14 --&gt;|yes| p1_action_15
185+
p1_action_15 --&gt; p1_action_16
186+
p1_action_16 --&gt; p1_stop_17
187+
p1_decision_14 --&gt;|no| p1_action_18
188+
p1_action_18 --&gt; p1_action_19
189+
p1_action_19 --&gt; p1_end_20
200190

201191
%% Styling
202192
classDef trigger fill:#f0f4ff,stroke:#5c7cfa,stroke-width:2px
@@ -212,40 +202,41 @@ <h2>CraftBusinessLeadToOrder</h2>
212202
<h2>QuoteToOrder</h2>
213203
<div class="summary-container">
214204

205+
215206
<p><strong>Triggered by:</strong> <code>quote.accepted</code></p>
216207
<p>Orchestrates business logic and state transitions for the <code>QuoteToOrder</code> process.</p>
217208

218209
</div>
219210
<div class="visual-container"><h3>Diagram</h3><pre class="mermaid">flowchart TD
220-
p1_start_1(["QuoteToOrder"])
211+
p1_start_1([&quot;QuoteToOrder&quot;])
221212
class p1_start_1 success
222-
p1_trigger_2[/ "when quote.accepted" /]
213+
p1_trigger_2[/ &quot;when quote.accepted&quot; /]
223214
class p1_trigger_2 trigger
224-
p1_decision_3{"if order.deposit_received = false"}
215+
p1_decision_3{&quot;if order.deposit_received = false&quot;}
225216
class p1_decision_3 decision
226-
p1_action_4["transition order.status to 'awaiting_deposit'"]
217+
p1_action_4[&quot;transition order.status to &#39;awaiting_deposit&#39;&quot;]
227218
class p1_action_4 action
228-
p1_action_5["notify finance with #quot;Deposit required before confirmation#quot;"]
219+
p1_action_5[&quot;notify finance with #quot;Deposit required before confirmation#quot;&quot;]
229220
class p1_action_5 action
230-
p1_stop_6(["stop"])
221+
p1_stop_6([&quot;stop&quot;])
231222
class p1_stop_6 stop
232-
p1_action_7["transition order.status to 'confirmed'"]
223+
p1_action_7[&quot;transition order.status to &#39;confirmed&#39;&quot;]
233224
class p1_action_7 action
234-
p1_action_8["create production_order"]
225+
p1_action_8[&quot;create production_order&quot;]
235226
class p1_action_8 action
236-
p1_action_9["notify operations with #quot;Order ready for production planning#quot;"]
227+
p1_action_9[&quot;notify operations with #quot;Order ready for production planning#quot;&quot;]
237228
class p1_action_9 action
238-
p1_end_10(["done"])
229+
p1_end_10([&quot;done&quot;])
239230
class p1_end_10 success
240-
p1_start_1 --> p1_trigger_2
241-
p1_trigger_2 --> p1_decision_3
242-
p1_decision_3 -->|yes| p1_action_4
243-
p1_action_4 --> p1_action_5
244-
p1_action_5 --> p1_stop_6
245-
p1_decision_3 -->|no| p1_action_7
246-
p1_action_7 --> p1_action_8
247-
p1_action_8 --> p1_action_9
248-
p1_action_9 --> p1_end_10
231+
p1_start_1 --&gt; p1_trigger_2
232+
p1_trigger_2 --&gt; p1_decision_3
233+
p1_decision_3 --&gt;|yes| p1_action_4
234+
p1_action_4 --&gt; p1_action_5
235+
p1_action_5 --&gt; p1_stop_6
236+
p1_decision_3 --&gt;|no| p1_action_7
237+
p1_action_7 --&gt; p1_action_8
238+
p1_action_8 --&gt; p1_action_9
239+
p1_action_9 --&gt; p1_end_10
249240

250241
%% Styling
251242
classDef trigger fill:#f0f4ff,stroke:#5c7cfa,stroke-width:2px
@@ -261,32 +252,33 @@ <h2>QuoteToOrder</h2>
261252
<h2>OrderLifecycle</h2>
262253
<div class="summary-container">
263254

255+
264256
<p><strong>States:</strong> <code>qualified</code>, <code>quoted</code>, <code>awaiting_deposit</code>, <code>confirmed</code>, <code>in_production</code>, <code>scheduled_for_installation</code>, <code>completed</code>, <code>cancelled</code></p>
265257
<p><strong>Transitions:</strong> 10 paths defined.</p>
266258

267259
</div>
268260
<div class="visual-container"><h3>Diagram</h3><pre class="mermaid">stateDiagram-v2
269-
state "qualified" as s1_state_1
270-
[*] --> s1_state_1
271-
state "quoted" as s1_state_2
272-
state "awaiting_deposit" as s1_state_3
273-
state "confirmed" as s1_state_4
274-
state "in_production" as s1_state_5
275-
state "scheduled_for_installation" as s1_state_6
276-
state "completed" as s1_state_7
277-
state "cancelled" as s1_state_8
278-
s1_state_1 --> s1_state_2
279-
s1_state_2 --> s1_state_3
280-
s1_state_2 --> s1_state_4
281-
s1_state_3 --> s1_state_4
282-
s1_state_4 --> s1_state_5
283-
s1_state_5 --> s1_state_6
284-
s1_state_6 --> s1_state_7
285-
s1_state_1 --> s1_state_8
286-
s1_state_2 --> s1_state_8
287-
s1_state_3 --> s1_state_8
288-
s1_state_7 --> [*]
289-
s1_state_8 --> [*]</pre></div>
261+
state &quot;qualified&quot; as s1_state_1
262+
[*] --&gt; s1_state_1
263+
state &quot;quoted&quot; as s1_state_2
264+
state &quot;awaiting_deposit&quot; as s1_state_3
265+
state &quot;confirmed&quot; as s1_state_4
266+
state &quot;in_production&quot; as s1_state_5
267+
state &quot;scheduled_for_installation&quot; as s1_state_6
268+
state &quot;completed&quot; as s1_state_7
269+
state &quot;cancelled&quot; as s1_state_8
270+
s1_state_1 --&gt; s1_state_2
271+
s1_state_2 --&gt; s1_state_3
272+
s1_state_2 --&gt; s1_state_4
273+
s1_state_3 --&gt; s1_state_4
274+
s1_state_4 --&gt; s1_state_5
275+
s1_state_5 --&gt; s1_state_6
276+
s1_state_6 --&gt; s1_state_7
277+
s1_state_1 --&gt; s1_state_8
278+
s1_state_2 --&gt; s1_state_8
279+
s1_state_3 --&gt; s1_state_8
280+
s1_state_7 --&gt; [*]
281+
s1_state_8 --&gt; [*]</pre></div>
290282
</section>
291283

292284

@@ -295,6 +287,7 @@ <h2>OrderLifecycle</h2>
295287
<h2>NoProductionWithoutDeposit</h2>
296288
<div class="summary-container">
297289

290+
298291
<p><strong>Scope:</strong> Applies to <code>order</code></p>
299292
<p>Contains behavioral constraints and logic for <code>NoProductionWithoutDeposit</code>.</p>
300293

@@ -305,7 +298,7 @@ <h2>NoProductionWithoutDeposit</h2>
305298
</main>
306299

307300
<footer>
308-
<p>OrgScript — Human-readable, AI-interpretable business logic.</p>
301+
<p>OrgScript - Human-readable, AI-interpretable business logic.</p>
309302
</footer>
310303

311304
<script type="module">

0 commit comments

Comments
 (0)