activating-expertise 0.1.0.dev0__py3-none-any.whl
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.
- activating_expertise-0.1.0.dev0.dist-info/METADATA +28 -0
- activating_expertise-0.1.0.dev0.dist-info/RECORD +61 -0
- activating_expertise-0.1.0.dev0.dist-info/WHEEL +5 -0
- activating_expertise-0.1.0.dev0.dist-info/entry_points.txt +2 -0
- activating_expertise-0.1.0.dev0.dist-info/licenses/LICENSE-DOCS +29 -0
- activating_expertise-0.1.0.dev0.dist-info/licenses/LICENSE-SOFTWARE +661 -0
- activating_expertise-0.1.0.dev0.dist-info/top_level.txt +1 -0
- ae/__init__.py +0 -0
- ae/analysis.py +193 -0
- ae/cli.py +496 -0
- ae/concept_server.py +209 -0
- ae/concept_viewer.py +640 -0
- ae/concepts.py +155 -0
- ae/core.py +1303 -0
- ae/dspy_xp.py +894 -0
- ae/graph.py +733 -0
- ae/guides/__init__.py +0 -0
- ae/guides/debugging.md +434 -0
- ae/guides/design_maturation.md +141 -0
- ae/guides/hygienator.md +334 -0
- ae/guides/landscape_review.md +175 -0
- ae/guides/model_evaluation.md +313 -0
- ae/guides/model_onboarding.md +386 -0
- ae/guides/operational_guide.md +869 -0
- ae/guides/process_improvement.md +296 -0
- ae/guides/quick_start.md +123 -0
- ae/guides/roadmap.md +443 -0
- ae/guides/synergistic_xp.md +416 -0
- ae/seed_concepts/__init__.py +1 -0
- ae/seed_concepts/ae-concept-context.jsonld +62 -0
- ae/seed_concepts/ai-keeping-up.jsonld +121 -0
- ae/seed_concepts/bc-activities.jsonld +97 -0
- ae/seed_concepts/bounded-rationality.jsonld +88 -0
- ae/seed_concepts/collaborative-agent.jsonld +91 -0
- ae/seed_concepts/coming-to-know.jsonld +123 -0
- ae/seed_concepts/complement.jsonld +360 -0
- ae/seed_concepts/comprehensibility-as-participation.jsonld +101 -0
- ae/seed_concepts/constellation-architecture.jsonld +136 -0
- ae/seed_concepts/decision-network.jsonld +120 -0
- ae/seed_concepts/design-maturation.jsonld +71 -0
- ae/seed_concepts/discourse-ontology.jsonld +126 -0
- ae/seed_concepts/divergence-regimes.jsonld +94 -0
- ae/seed_concepts/dominator-pattern.jsonld +103 -0
- ae/seed_concepts/emergent-paradigm-adoption.jsonld +107 -0
- ae/seed_concepts/epistemic-integrity.jsonld +102 -0
- ae/seed_concepts/human-universe.jsonld +154 -0
- ae/seed_concepts/kinship.jsonld +122 -0
- ae/seed_concepts/override-safety.jsonld +97 -0
- ae/seed_concepts/partnership.jsonld +136 -0
- ae/seed_concepts/persona-activation-as-ceremony.jsonld +130 -0
- ae/seed_concepts/process-as-medium.jsonld +102 -0
- ae/seed_concepts/process-selection.jsonld +71 -0
- ae/seed_concepts/tangent-as-signal.jsonld +85 -0
- ae/serve.py +192 -0
- ae/session_server.py +305 -0
- ae/sync.py +134 -0
- ae/teams/__init__.py +0 -0
- ae/teams/problem_solving.md +34 -0
- ae/teams/problem_solving_complete.md +735 -0
- ae/view.py +1357 -0
- ae/work.py +815 -0
ae/concept_viewer.py
ADDED
|
@@ -0,0 +1,640 @@
|
|
|
1
|
+
"""Concept viewer — Tufte-style HTML visualization of concept nodes.
|
|
2
|
+
|
|
3
|
+
Renders JSON-LD concept files as a single self-contained HTML page
|
|
4
|
+
with small-multiples layout: one card per concept, each showing
|
|
5
|
+
the five-part structure (content, issues, complement, boundary,
|
|
6
|
+
perspectives) for comparison across concepts.
|
|
7
|
+
|
|
8
|
+
Designed for comprehensibility (safeguard b): the human must be able
|
|
9
|
+
to see and evaluate concept content clearly.
|
|
10
|
+
"""
|
|
11
|
+
|
|
12
|
+
import json
|
|
13
|
+
import threading
|
|
14
|
+
import webbrowser
|
|
15
|
+
from html import escape
|
|
16
|
+
from http.server import HTTPServer, SimpleHTTPRequestHandler
|
|
17
|
+
from pathlib import Path
|
|
18
|
+
|
|
19
|
+
from ae.concepts import load_concept_store, ConceptStore
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
def _holder_name(holder: str) -> str:
|
|
23
|
+
"""Extract human-readable name from ae:PersonaName."""
|
|
24
|
+
if ":" in holder:
|
|
25
|
+
return holder.split(":")[-1]
|
|
26
|
+
return holder
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
def _status_color(status: str) -> str:
|
|
30
|
+
"""Map issue/lifecycle status to a muted color."""
|
|
31
|
+
return {
|
|
32
|
+
"open": "#c9553a",
|
|
33
|
+
"acknowledged": "#b87d3a",
|
|
34
|
+
"addressed": "#4a8c5c",
|
|
35
|
+
"dismissed": "#888",
|
|
36
|
+
"active": "#4a8c5c",
|
|
37
|
+
"challenged": "#c9553a",
|
|
38
|
+
"superseded": "#888",
|
|
39
|
+
"disproven": "#666",
|
|
40
|
+
}.get(status, "#888")
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
def _render_issues(issues: list[dict]) -> str:
|
|
44
|
+
"""Render issues as a compact list with status badges."""
|
|
45
|
+
if not issues:
|
|
46
|
+
return '<p class="empty">No issues tracked.</p>'
|
|
47
|
+
parts = []
|
|
48
|
+
for issue in issues:
|
|
49
|
+
status = issue.get("ae:issueStatus", "unknown")
|
|
50
|
+
defn = escape(issue.get("skos:definition", ""))
|
|
51
|
+
identified_by = _holder_name(issue.get("ae:identifiedBy", ""))
|
|
52
|
+
session = issue.get("ae:identifiedInSession", "")
|
|
53
|
+
color = _status_color(status)
|
|
54
|
+
rationale = issue.get("ae:dismissalRationale", "")
|
|
55
|
+
resolution = issue.get("ae:addressedResolution", "")
|
|
56
|
+
|
|
57
|
+
parts.append(f'<div class="issue">')
|
|
58
|
+
parts.append(f' <span class="badge" style="background:{color}">{escape(status)}</span>')
|
|
59
|
+
parts.append(f' <span class="issue-text">{defn}</span>')
|
|
60
|
+
source_parts = []
|
|
61
|
+
if identified_by:
|
|
62
|
+
source_parts.append(identified_by)
|
|
63
|
+
if session:
|
|
64
|
+
source_parts.append(session)
|
|
65
|
+
if source_parts:
|
|
66
|
+
parts.append(f' <span class="source">— {escape(", ".join(source_parts))}</span>')
|
|
67
|
+
if rationale:
|
|
68
|
+
parts.append(f' <div class="rationale">Dismissal rationale: {escape(rationale)}</div>')
|
|
69
|
+
if resolution:
|
|
70
|
+
parts.append(f' <div class="rationale">Resolution: {escape(resolution)}</div>')
|
|
71
|
+
parts.append('</div>')
|
|
72
|
+
return "\n".join(parts)
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
def _render_complement(complement: dict | None, label: str) -> str:
|
|
76
|
+
"""Render a complement description."""
|
|
77
|
+
if not complement:
|
|
78
|
+
return f'<p class="empty">No {label} described.</p>'
|
|
79
|
+
defn = escape(complement.get("skos:definition", ""))
|
|
80
|
+
return f'<div class="complement-text">{defn}</div>'
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
def _render_boundary(boundary: dict | None) -> str:
|
|
84
|
+
"""Render a boundary description."""
|
|
85
|
+
if not boundary:
|
|
86
|
+
return '<p class="empty">No boundary described.</p>'
|
|
87
|
+
parts = []
|
|
88
|
+
includes = boundary.get("ae:boundaryIncludes", "")
|
|
89
|
+
excludes = boundary.get("ae:boundaryExcludes", "")
|
|
90
|
+
rationale = boundary.get("ae:boundaryRationale", "")
|
|
91
|
+
if includes:
|
|
92
|
+
parts.append(f'<div class="boundary-section"><strong>Includes:</strong> {escape(includes)}</div>')
|
|
93
|
+
if excludes:
|
|
94
|
+
parts.append(f'<div class="boundary-section"><strong>Excludes:</strong> {escape(excludes)}</div>')
|
|
95
|
+
if rationale:
|
|
96
|
+
parts.append(f'<div class="boundary-section boundary-rationale"><strong>Rationale:</strong> {escape(rationale)}</div>')
|
|
97
|
+
return "\n".join(parts)
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
def _render_perspectives(perspectives: list[dict], tension: str = "") -> str:
|
|
101
|
+
"""Render per-persona interpretations."""
|
|
102
|
+
if not perspectives:
|
|
103
|
+
return '<p class="empty">No perspectives recorded.</p>'
|
|
104
|
+
parts = []
|
|
105
|
+
for p in perspectives:
|
|
106
|
+
holder = _holder_name(p.get("ae:perspectiveHolder", ""))
|
|
107
|
+
defn = escape(p.get("skos:definition", ""))
|
|
108
|
+
parts.append(f'<div class="perspective">')
|
|
109
|
+
parts.append(f' <span class="persona-name">{escape(holder)}</span>')
|
|
110
|
+
parts.append(f' <div class="perspective-text">{defn}</div>')
|
|
111
|
+
parts.append('</div>')
|
|
112
|
+
if tension:
|
|
113
|
+
parts.append(f'<div class="productive-tension"><strong>Productive tension:</strong> {escape(tension)}</div>')
|
|
114
|
+
return "\n".join(parts)
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
def _render_relationships(node) -> str:
|
|
118
|
+
"""Render broader/narrower/related relationships."""
|
|
119
|
+
parts = []
|
|
120
|
+
if node.broader:
|
|
121
|
+
label = node.broader.split("/")[-1]
|
|
122
|
+
parts.append(f'<span class="rel-tag rel-broader">↑ {escape(label)}</span>')
|
|
123
|
+
for n in node.narrower:
|
|
124
|
+
label = n.split("/")[-1]
|
|
125
|
+
parts.append(f'<span class="rel-tag rel-narrower">↓ {escape(label)}</span>')
|
|
126
|
+
related = node.content.get("skos:related", [])
|
|
127
|
+
if isinstance(related, str):
|
|
128
|
+
related = [related]
|
|
129
|
+
for r in related:
|
|
130
|
+
label = r.split("/")[-1]
|
|
131
|
+
parts.append(f'<span class="rel-tag rel-related">↔ {escape(label)}</span>')
|
|
132
|
+
if not parts:
|
|
133
|
+
return ""
|
|
134
|
+
return '<div class="relationships">' + " ".join(parts) + '</div>'
|
|
135
|
+
|
|
136
|
+
|
|
137
|
+
def render_concept_html(store: ConceptStore) -> str:
|
|
138
|
+
"""Render a full concept store as a self-contained HTML page."""
|
|
139
|
+
concept_cards = []
|
|
140
|
+
|
|
141
|
+
for concept_id in sorted(store.concepts.keys()):
|
|
142
|
+
node = store.concepts[concept_id]
|
|
143
|
+
status_color = _status_color(node.validity_status)
|
|
144
|
+
tension = node.content.get("ae:productiveTension", "")
|
|
145
|
+
change_note = node.content.get("skos:changeNote", "")
|
|
146
|
+
|
|
147
|
+
card_id = node.pref_label.lower().replace(" ", "-").replace("/", "-")
|
|
148
|
+
card = f"""
|
|
149
|
+
<article class="concept-card" id="concept-{card_id}">
|
|
150
|
+
<header>
|
|
151
|
+
<h2>{escape(node.pref_label)}</h2>
|
|
152
|
+
<span class="badge" style="background:{status_color}">{escape(node.validity_status)}</span>
|
|
153
|
+
{_render_relationships(node)}
|
|
154
|
+
</header>
|
|
155
|
+
|
|
156
|
+
<div class="alt-labels">
|
|
157
|
+
Also known as: {', '.join(escape(a) for a in node.alt_labels) if node.alt_labels else '<em>none</em>'}
|
|
158
|
+
</div>
|
|
159
|
+
|
|
160
|
+
<section class="part shared-kernel">
|
|
161
|
+
<h3>Shared Kernel</h3>
|
|
162
|
+
<div class="kernel-text">{escape(node.shared_kernel)}</div>
|
|
163
|
+
</section>
|
|
164
|
+
|
|
165
|
+
<div class="two-col">
|
|
166
|
+
<section class="part complement">
|
|
167
|
+
<h3>Internal Complement <span class="part-hint">what it hides within</span></h3>
|
|
168
|
+
{_render_complement(node.internal_complement, "internal complement")}
|
|
169
|
+
</section>
|
|
170
|
+
|
|
171
|
+
<section class="part complement">
|
|
172
|
+
<h3>External Complement <span class="part-hint">what it excludes</span></h3>
|
|
173
|
+
{_render_complement(node.external_complement, "external complement")}
|
|
174
|
+
</section>
|
|
175
|
+
</div>
|
|
176
|
+
|
|
177
|
+
<section class="part boundary">
|
|
178
|
+
<h3>Boundary <span class="part-hint">the constructed line</span></h3>
|
|
179
|
+
{_render_boundary(node.boundary)}
|
|
180
|
+
</section>
|
|
181
|
+
|
|
182
|
+
<section class="part issues">
|
|
183
|
+
<h3>Issues <span class="issue-count">{len(node.issues)} tracked</span></h3>
|
|
184
|
+
{_render_issues(node.issues)}
|
|
185
|
+
</section>
|
|
186
|
+
|
|
187
|
+
<section class="part perspectives">
|
|
188
|
+
<h3>Per-Persona Interpretations</h3>
|
|
189
|
+
{_render_perspectives(node.perspectives, tension)}
|
|
190
|
+
</section>
|
|
191
|
+
|
|
192
|
+
{"<div class='change-note'>Last change: " + escape(change_note) + "</div>" if change_note else ""}
|
|
193
|
+
</article>
|
|
194
|
+
"""
|
|
195
|
+
concept_cards.append(card)
|
|
196
|
+
|
|
197
|
+
# Build summary table rows outside f-string (backslash escapes
|
|
198
|
+
# in f-string expressions are not allowed in Python < 3.12)
|
|
199
|
+
summary_rows_list = []
|
|
200
|
+
for node in sorted(store.concepts.values(), key=lambda n: n.pref_label):
|
|
201
|
+
cid = node.pref_label.lower().replace(" ", "-").replace("/", "-")
|
|
202
|
+
open_issues = sum(1 for i in node.issues if i.get("ae:issueStatus") == "open")
|
|
203
|
+
has_complement = (
|
|
204
|
+
"yes" if node.internal_complement and node.external_complement
|
|
205
|
+
else "partial" if node.internal_complement or node.external_complement
|
|
206
|
+
else "no"
|
|
207
|
+
)
|
|
208
|
+
has_boundary = "yes" if node.boundary else "no"
|
|
209
|
+
summary_rows_list.append(
|
|
210
|
+
f'<tr onclick="document.getElementById('
|
|
211
|
+
f"'concept-{cid}'"
|
|
212
|
+
f').scrollIntoView({{behavior: '
|
|
213
|
+
f"'smooth'"
|
|
214
|
+
f'}})" style="cursor:pointer">'
|
|
215
|
+
f'<td><a href="#concept-{cid}" style="color:inherit;text-decoration:none">{escape(node.pref_label)}</a></td>'
|
|
216
|
+
f'<td><span class="badge" style="background:{_status_color(node.validity_status)}">{escape(node.validity_status)}</span></td>'
|
|
217
|
+
f'<td>{len(node.perspectives)}</td>'
|
|
218
|
+
f'<td>{open_issues}/{len(node.issues)}</td>'
|
|
219
|
+
f'<td>{has_complement}</td>'
|
|
220
|
+
f'<td>{has_boundary}</td>'
|
|
221
|
+
f'</tr>'
|
|
222
|
+
)
|
|
223
|
+
summary_rows = "".join(summary_rows_list)
|
|
224
|
+
|
|
225
|
+
return f"""<!DOCTYPE html>
|
|
226
|
+
<html lang="en">
|
|
227
|
+
<head>
|
|
228
|
+
<meta charset="UTF-8">
|
|
229
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
230
|
+
<title>AE Concept Viewer — {store.concept_count} concepts</title>
|
|
231
|
+
<style>
|
|
232
|
+
/* Tufte-inspired: high data-ink ratio, no chartjunk */
|
|
233
|
+
* {{ margin: 0; padding: 0; box-sizing: border-box; }}
|
|
234
|
+
|
|
235
|
+
body {{
|
|
236
|
+
font-family: 'Palatino Linotype', Palatino, 'Book Antiqua', Georgia, serif;
|
|
237
|
+
max-width: 1400px;
|
|
238
|
+
margin: 0 auto;
|
|
239
|
+
padding: 2rem 1.5rem;
|
|
240
|
+
background: #fffff8;
|
|
241
|
+
color: #333;
|
|
242
|
+
line-height: 1.5;
|
|
243
|
+
}}
|
|
244
|
+
|
|
245
|
+
h1 {{
|
|
246
|
+
font-size: 1.8rem;
|
|
247
|
+
font-weight: normal;
|
|
248
|
+
margin-bottom: 0.3rem;
|
|
249
|
+
color: #111;
|
|
250
|
+
}}
|
|
251
|
+
|
|
252
|
+
.subtitle {{
|
|
253
|
+
font-size: 0.95rem;
|
|
254
|
+
color: #666;
|
|
255
|
+
margin-bottom: 2rem;
|
|
256
|
+
font-style: italic;
|
|
257
|
+
}}
|
|
258
|
+
|
|
259
|
+
.concept-card {{
|
|
260
|
+
border-top: 2px solid #333;
|
|
261
|
+
padding: 1.5rem 0;
|
|
262
|
+
margin-bottom: 2rem;
|
|
263
|
+
}}
|
|
264
|
+
|
|
265
|
+
.concept-card header {{
|
|
266
|
+
display: flex;
|
|
267
|
+
align-items: baseline;
|
|
268
|
+
flex-wrap: wrap;
|
|
269
|
+
gap: 0.5rem;
|
|
270
|
+
margin-bottom: 0.5rem;
|
|
271
|
+
}}
|
|
272
|
+
|
|
273
|
+
.concept-card h2 {{
|
|
274
|
+
font-size: 1.4rem;
|
|
275
|
+
font-weight: normal;
|
|
276
|
+
color: #111;
|
|
277
|
+
}}
|
|
278
|
+
|
|
279
|
+
.alt-labels {{
|
|
280
|
+
font-size: 0.85rem;
|
|
281
|
+
color: #777;
|
|
282
|
+
margin-bottom: 1rem;
|
|
283
|
+
font-style: italic;
|
|
284
|
+
}}
|
|
285
|
+
|
|
286
|
+
h3 {{
|
|
287
|
+
font-size: 0.95rem;
|
|
288
|
+
font-weight: 600;
|
|
289
|
+
text-transform: uppercase;
|
|
290
|
+
letter-spacing: 0.05em;
|
|
291
|
+
color: #555;
|
|
292
|
+
margin-bottom: 0.4rem;
|
|
293
|
+
}}
|
|
294
|
+
|
|
295
|
+
.part-hint {{
|
|
296
|
+
font-weight: normal;
|
|
297
|
+
text-transform: none;
|
|
298
|
+
letter-spacing: normal;
|
|
299
|
+
font-style: italic;
|
|
300
|
+
color: #888;
|
|
301
|
+
font-size: 0.85rem;
|
|
302
|
+
}}
|
|
303
|
+
|
|
304
|
+
.part {{
|
|
305
|
+
margin-bottom: 1.2rem;
|
|
306
|
+
padding-left: 0.5rem;
|
|
307
|
+
border-left: 3px solid #e0e0d8;
|
|
308
|
+
}}
|
|
309
|
+
|
|
310
|
+
.kernel-text {{
|
|
311
|
+
font-size: 1.05rem;
|
|
312
|
+
line-height: 1.6;
|
|
313
|
+
}}
|
|
314
|
+
|
|
315
|
+
/* Two-column layout for complements */
|
|
316
|
+
.two-col {{
|
|
317
|
+
display: grid;
|
|
318
|
+
grid-template-columns: 1fr 1fr;
|
|
319
|
+
gap: 1.5rem;
|
|
320
|
+
}}
|
|
321
|
+
@media (max-width: 800px) {{
|
|
322
|
+
.two-col {{ grid-template-columns: 1fr; }}
|
|
323
|
+
}}
|
|
324
|
+
|
|
325
|
+
.complement-text, .boundary-section {{
|
|
326
|
+
font-size: 0.93rem;
|
|
327
|
+
line-height: 1.5;
|
|
328
|
+
margin-bottom: 0.5rem;
|
|
329
|
+
}}
|
|
330
|
+
|
|
331
|
+
.boundary-rationale {{
|
|
332
|
+
margin-top: 0.5rem;
|
|
333
|
+
padding-top: 0.5rem;
|
|
334
|
+
border-top: 1px solid #e0e0d8;
|
|
335
|
+
font-style: italic;
|
|
336
|
+
}}
|
|
337
|
+
|
|
338
|
+
/* Issues */
|
|
339
|
+
.issue {{
|
|
340
|
+
margin-bottom: 0.7rem;
|
|
341
|
+
padding-bottom: 0.7rem;
|
|
342
|
+
border-bottom: 1px solid #eee;
|
|
343
|
+
}}
|
|
344
|
+
.issue:last-child {{ border-bottom: none; }}
|
|
345
|
+
|
|
346
|
+
.issue-text {{
|
|
347
|
+
font-size: 0.93rem;
|
|
348
|
+
}}
|
|
349
|
+
|
|
350
|
+
.issue-count {{
|
|
351
|
+
font-weight: normal;
|
|
352
|
+
text-transform: none;
|
|
353
|
+
letter-spacing: normal;
|
|
354
|
+
color: #888;
|
|
355
|
+
font-size: 0.85rem;
|
|
356
|
+
}}
|
|
357
|
+
|
|
358
|
+
.source {{
|
|
359
|
+
font-size: 0.8rem;
|
|
360
|
+
color: #888;
|
|
361
|
+
display: block;
|
|
362
|
+
margin-top: 0.2rem;
|
|
363
|
+
}}
|
|
364
|
+
|
|
365
|
+
.rationale {{
|
|
366
|
+
font-size: 0.85rem;
|
|
367
|
+
color: #666;
|
|
368
|
+
font-style: italic;
|
|
369
|
+
margin-top: 0.3rem;
|
|
370
|
+
padding-left: 0.5rem;
|
|
371
|
+
}}
|
|
372
|
+
|
|
373
|
+
/* Badge for status */
|
|
374
|
+
.badge {{
|
|
375
|
+
display: inline-block;
|
|
376
|
+
font-size: 0.7rem;
|
|
377
|
+
font-family: -apple-system, sans-serif;
|
|
378
|
+
padding: 0.15em 0.5em;
|
|
379
|
+
border-radius: 3px;
|
|
380
|
+
color: white;
|
|
381
|
+
text-transform: uppercase;
|
|
382
|
+
letter-spacing: 0.05em;
|
|
383
|
+
vertical-align: middle;
|
|
384
|
+
}}
|
|
385
|
+
|
|
386
|
+
/* Perspectives */
|
|
387
|
+
.perspective {{
|
|
388
|
+
margin-bottom: 1rem;
|
|
389
|
+
padding-bottom: 1rem;
|
|
390
|
+
border-bottom: 1px solid #eee;
|
|
391
|
+
}}
|
|
392
|
+
.perspective:last-child {{ border-bottom: none; }}
|
|
393
|
+
|
|
394
|
+
.persona-name {{
|
|
395
|
+
font-weight: 600;
|
|
396
|
+
font-size: 0.95rem;
|
|
397
|
+
color: #333;
|
|
398
|
+
}}
|
|
399
|
+
|
|
400
|
+
.perspective-text {{
|
|
401
|
+
font-size: 0.93rem;
|
|
402
|
+
margin-top: 0.3rem;
|
|
403
|
+
line-height: 1.5;
|
|
404
|
+
}}
|
|
405
|
+
|
|
406
|
+
.productive-tension {{
|
|
407
|
+
margin-top: 1rem;
|
|
408
|
+
padding: 0.7rem;
|
|
409
|
+
background: #f5f5ee;
|
|
410
|
+
border-left: 3px solid #b87d3a;
|
|
411
|
+
font-size: 0.9rem;
|
|
412
|
+
line-height: 1.5;
|
|
413
|
+
}}
|
|
414
|
+
|
|
415
|
+
/* Relationships */
|
|
416
|
+
.relationships {{
|
|
417
|
+
margin-left: auto;
|
|
418
|
+
}}
|
|
419
|
+
.rel-tag {{
|
|
420
|
+
display: inline-block;
|
|
421
|
+
font-size: 0.75rem;
|
|
422
|
+
font-family: -apple-system, sans-serif;
|
|
423
|
+
padding: 0.1em 0.4em;
|
|
424
|
+
border-radius: 3px;
|
|
425
|
+
border: 1px solid #ccc;
|
|
426
|
+
color: #666;
|
|
427
|
+
margin-left: 0.3rem;
|
|
428
|
+
}}
|
|
429
|
+
|
|
430
|
+
.change-note {{
|
|
431
|
+
font-size: 0.8rem;
|
|
432
|
+
color: #999;
|
|
433
|
+
margin-top: 0.5rem;
|
|
434
|
+
font-style: italic;
|
|
435
|
+
}}
|
|
436
|
+
|
|
437
|
+
.empty {{
|
|
438
|
+
font-style: italic;
|
|
439
|
+
color: #999;
|
|
440
|
+
font-size: 0.9rem;
|
|
441
|
+
}}
|
|
442
|
+
|
|
443
|
+
/* Summary table at top */
|
|
444
|
+
.summary-table {{
|
|
445
|
+
width: 100%;
|
|
446
|
+
border-collapse: collapse;
|
|
447
|
+
margin-bottom: 2rem;
|
|
448
|
+
font-size: 0.85rem;
|
|
449
|
+
font-family: -apple-system, sans-serif;
|
|
450
|
+
}}
|
|
451
|
+
.summary-table th {{
|
|
452
|
+
text-align: left;
|
|
453
|
+
padding: 0.4rem 0.8rem;
|
|
454
|
+
border-bottom: 2px solid #333;
|
|
455
|
+
font-weight: 600;
|
|
456
|
+
color: #555;
|
|
457
|
+
}}
|
|
458
|
+
.summary-table td {{
|
|
459
|
+
padding: 0.4rem 0.8rem;
|
|
460
|
+
border-bottom: 1px solid #eee;
|
|
461
|
+
}}
|
|
462
|
+
.summary-table tbody tr:hover {{
|
|
463
|
+
background: #f0f0f0;
|
|
464
|
+
}}
|
|
465
|
+
|
|
466
|
+
/* About-this-store dropdown */
|
|
467
|
+
.about-store {{
|
|
468
|
+
margin-bottom: 2rem;
|
|
469
|
+
padding: 0.8rem 1rem;
|
|
470
|
+
background: #f5f5ee;
|
|
471
|
+
border-left: 3px solid #7a7a66;
|
|
472
|
+
border-radius: 3px;
|
|
473
|
+
}}
|
|
474
|
+
.about-store > summary {{
|
|
475
|
+
cursor: pointer;
|
|
476
|
+
font-weight: 600;
|
|
477
|
+
font-size: 0.95rem;
|
|
478
|
+
color: #333;
|
|
479
|
+
font-family: -apple-system, sans-serif;
|
|
480
|
+
}}
|
|
481
|
+
.about-store > summary:hover {{ color: #000; }}
|
|
482
|
+
.about-store[open] > summary {{ margin-bottom: 0.8rem; }}
|
|
483
|
+
.about-store h3 {{
|
|
484
|
+
font-size: 1rem;
|
|
485
|
+
margin: 1rem 0 0.4rem 0;
|
|
486
|
+
color: #333;
|
|
487
|
+
font-family: Georgia, serif;
|
|
488
|
+
}}
|
|
489
|
+
.about-store h3:first-of-type {{ margin-top: 0.5rem; }}
|
|
490
|
+
.about-store p, .about-store ul, .about-store li {{
|
|
491
|
+
font-size: 0.9rem;
|
|
492
|
+
line-height: 1.55;
|
|
493
|
+
}}
|
|
494
|
+
.about-store ul {{ margin: 0.3rem 0 0.6rem 1.3rem; padding: 0; }}
|
|
495
|
+
.about-store li {{ margin-bottom: 0.25rem; }}
|
|
496
|
+
.about-store .formal-box {{
|
|
497
|
+
background: #fff;
|
|
498
|
+
border: 1px solid #ddd;
|
|
499
|
+
padding: 0.8rem;
|
|
500
|
+
margin: 0.5rem 0;
|
|
501
|
+
font-size: 0.88rem;
|
|
502
|
+
}}
|
|
503
|
+
.about-store .formal-box code {{
|
|
504
|
+
font-family: ui-monospace, monospace;
|
|
505
|
+
background: #f0f0e8;
|
|
506
|
+
padding: 0 0.2em;
|
|
507
|
+
}}
|
|
508
|
+
.about-store .qualifier {{
|
|
509
|
+
background: #fcf5e8;
|
|
510
|
+
border-left: 3px solid #b87d3a;
|
|
511
|
+
padding: 0.5rem 0.8rem;
|
|
512
|
+
margin: 0.6rem 0;
|
|
513
|
+
font-size: 0.88rem;
|
|
514
|
+
}}
|
|
515
|
+
</style>
|
|
516
|
+
</head>
|
|
517
|
+
<body>
|
|
518
|
+
<h1>AE Concept Store</h1>
|
|
519
|
+
<p class="subtitle">{store.concept_count} concepts — each with five parts: kernel, complement, boundary, issues, perspectives</p>
|
|
520
|
+
|
|
521
|
+
<details class="about-store">
|
|
522
|
+
<summary>About AE concept cards — what they are and how to read them</summary>
|
|
523
|
+
|
|
524
|
+
<h3>What is this page?</h3>
|
|
525
|
+
<p>This is a <strong>concept store</strong> — part of <strong>Activating Expertise</strong> (AE), a methodology for human-AI collaborative reasoning. Each entry is a <strong>concept card</strong>: a structured record of an idea a team has developed across many sessions.</p>
|
|
526
|
+
<p>Concept cards are a tool within the AE method. Every practitioner using AE builds their own concept store as their team works — the concepts reflect what that practitioner and their team have developed. The store you are looking at happens to contain the concepts developed for the AE project itself (the project that created and refined the method). They are available for other practitioners to see, use, and build on, but they are not a canonical or complete set. A practitioner working in a different domain — engineering, medicine, policy, writing — will develop their own concepts reflecting their own work and their own developmental path.</p>
|
|
527
|
+
<p>In AE, sessions bring together a human and a group of historical figures, brought to life as AI personas, to think through a problem together. Concepts that emerge from those sessions get captured in cards. The team develops, refines, and sometimes retires them over time.</p>
|
|
528
|
+
|
|
529
|
+
<h3>Why concept cards exist</h3>
|
|
530
|
+
<p>Practitioners using AE work on complex problems across many sessions. Without shared long-term memory, a team would re-explain foundational ideas every time, or lose the depth developed through prior work. Concept cards are the mechanism that lets a team (and the human working with that team):</p>
|
|
531
|
+
<ul>
|
|
532
|
+
<li><strong>Operate at a higher level of discourse</strong> — a reference to a named concept can carry its full developed meaning without re-explanation every time.</li>
|
|
533
|
+
<li><strong>Expand the scope of thinking</strong> — the team builds on prior insights rather than starting from scratch in each session. This allows engagement with ideas too complex to develop in a single sitting.</li>
|
|
534
|
+
<li><strong>Operationalize advanced concepts</strong> — ideas that would otherwise remain philosophical abstractions become structured, actionable tools. For example, in this store the <em>complement</em> concept card is tied to a concrete verification process in the operational guide.</li>
|
|
535
|
+
</ul>
|
|
536
|
+
|
|
537
|
+
<h3>Why the specific structure?</h3>
|
|
538
|
+
<p>In collaborative work, concepts tend to drift. They flatten into slogans, harden into received wisdom that nobody questions, or lose the honest doubts that made them useful. The card structure resists this by giving equal visibility to what the concept asserts, what it leaves out, and what open questions it carries.</p>
|
|
539
|
+
|
|
540
|
+
<h3>The five parts of a card</h3>
|
|
541
|
+
<ul>
|
|
542
|
+
<li><strong>Shared kernel</strong> — the concept's core meaning. What most of the team agrees on.</li>
|
|
543
|
+
<li><strong>Perspectives</strong> — how individual team members see the concept differently. Disagreement is preserved, not smoothed over.</li>
|
|
544
|
+
<li><strong>Issues</strong> — open problems and honest critiques. A card with no issues is either trivial or has been protected from challenge.</li>
|
|
545
|
+
<li><strong>Complement</strong> — what the concept leaves out, excludes, or trades away. This is the card's honesty check.</li>
|
|
546
|
+
<li><strong>Boundary</strong> — where the concept stops applying, with reasons.</li>
|
|
547
|
+
</ul>
|
|
548
|
+
|
|
549
|
+
<h3>How to read a card</h3>
|
|
550
|
+
<ol style="margin: 0.3rem 0 0.6rem 1.5rem; padding: 0;">
|
|
551
|
+
<li>Start with the shared kernel.</li>
|
|
552
|
+
<li>Notice which perspective resonates with you. That tells you something about your own frame.</li>
|
|
553
|
+
<li>Read the complement. It shows what the concept is not, and what choosing it gave up.</li>
|
|
554
|
+
<li>Read the issues. They are honest practice, not indictment.</li>
|
|
555
|
+
<li>Check the boundary. If your situation is outside it, the concept may not apply.</li>
|
|
556
|
+
</ol>
|
|
557
|
+
|
|
558
|
+
<h3>A closer look at the complement</h3>
|
|
559
|
+
<p>For everyday reading, treat the complement as "what this concept excludes or trades away." If you want to go further, the complement is usually doing three distinct kinds of work:</p>
|
|
560
|
+
<ul>
|
|
561
|
+
<li><strong>Errors</strong> — places where the concept would contradict something it shouldn't. Signals something to fix.</li>
|
|
562
|
+
<li><strong>Tradeoffs</strong> — legitimate alternatives the team chose not to take. Signals design rationale.</li>
|
|
563
|
+
<li><strong>Horizons</strong> — perspectives the team has not yet considered. Signals questions worth exploring later.</li>
|
|
564
|
+
</ul>
|
|
565
|
+
<p>The complement also has a dimension for consequences across time — whether a concept's long-term effects stay compatible with genuine human life, and what new possibilities it opens. The full formal structure lives in the <em>complement</em> concept card itself, and the process for checking it is in Section 7b of the operational guide.</p>
|
|
566
|
+
|
|
567
|
+
<h3>What this page is not</h3>
|
|
568
|
+
<ul>
|
|
569
|
+
<li><strong>Not exhaustive.</strong> Concepts the team has not yet developed are absent by definition.</li>
|
|
570
|
+
<li><strong>Not neutral.</strong> The team operates from a partnership orientation (the stance is named on each card's boundary, with framework markers where relevant). We try to be honest about our position rather than hide it.</li>
|
|
571
|
+
<li><strong>Not finished.</strong> Each card has a change history and open issues. Cards evolve as the team works.</li>
|
|
572
|
+
</ul>
|
|
573
|
+
|
|
574
|
+
<h3>A note to newcomers</h3>
|
|
575
|
+
<p>If something here is unclear, that is information we want. The cards are not meant to be authoritative pronouncements; they are the team's honest attempt to keep thinking across time. If a reading of yours differs from what a card says, your reading is welcome — the issues list is where such differences get recorded.</p>
|
|
576
|
+
</details>
|
|
577
|
+
|
|
578
|
+
<table class="summary-table">
|
|
579
|
+
<thead>
|
|
580
|
+
<tr>
|
|
581
|
+
<th>Concept</th>
|
|
582
|
+
<th>Status</th>
|
|
583
|
+
<th>Perspectives</th>
|
|
584
|
+
<th>Issues (open)</th>
|
|
585
|
+
<th>Has complement</th>
|
|
586
|
+
<th>Has boundary</th>
|
|
587
|
+
</tr>
|
|
588
|
+
</thead>
|
|
589
|
+
<tbody>
|
|
590
|
+
{summary_rows}
|
|
591
|
+
</tbody>
|
|
592
|
+
</table>
|
|
593
|
+
|
|
594
|
+
{"".join(concept_cards)}
|
|
595
|
+
|
|
596
|
+
<footer style="margin-top:3rem; padding-top:1rem; border-top:1px solid #ccc; font-size:0.8rem; color:#999;">
|
|
597
|
+
Generated from {store.concept_count} JSON-LD concept files. Visualization follows Tufte's principles: high data-ink ratio, no chartjunk, honest representation.
|
|
598
|
+
</footer>
|
|
599
|
+
</body>
|
|
600
|
+
</html>"""
|
|
601
|
+
|
|
602
|
+
|
|
603
|
+
def serve_concept_viewer(concepts_path: Path, port: int = 8891):
|
|
604
|
+
"""Generate concept HTML and serve it in the browser."""
|
|
605
|
+
store = load_concept_store(concepts_path)
|
|
606
|
+
if store.concept_count == 0:
|
|
607
|
+
print(f"No concept files found in {concepts_path}")
|
|
608
|
+
return
|
|
609
|
+
|
|
610
|
+
html = render_concept_html(store)
|
|
611
|
+
|
|
612
|
+
# Write to temp file and serve
|
|
613
|
+
output_dir = concepts_path / ".viewer"
|
|
614
|
+
output_dir.mkdir(exist_ok=True)
|
|
615
|
+
output_file = output_dir / "concepts.html"
|
|
616
|
+
output_file.write_text(html, encoding="utf-8")
|
|
617
|
+
|
|
618
|
+
class Handler(SimpleHTTPRequestHandler):
|
|
619
|
+
def __init__(self, *args, **kwargs):
|
|
620
|
+
super().__init__(*args, directory=str(output_dir), **kwargs)
|
|
621
|
+
def log_message(self, format, *args):
|
|
622
|
+
pass # silent
|
|
623
|
+
|
|
624
|
+
server = HTTPServer(("127.0.0.1", port), Handler)
|
|
625
|
+
url = f"http://127.0.0.1:{port}/concepts.html"
|
|
626
|
+
print(f"Serving concept viewer at {url}")
|
|
627
|
+
print("Press Ctrl+C to stop.")
|
|
628
|
+
|
|
629
|
+
threading.Timer(0.5, lambda: webbrowser.open(url)).start()
|
|
630
|
+
try:
|
|
631
|
+
server.serve_forever()
|
|
632
|
+
except KeyboardInterrupt:
|
|
633
|
+
server.shutdown()
|
|
634
|
+
print("\nStopped.")
|
|
635
|
+
|
|
636
|
+
|
|
637
|
+
if __name__ == "__main__":
|
|
638
|
+
import sys
|
|
639
|
+
path = Path(sys.argv[1]) if len(sys.argv) > 1 else Path("src/ae/seed_concepts")
|
|
640
|
+
serve_concept_viewer(path)
|