Pivot to text-first column-stack workspace + merge-with-review across AI artifacts
Workspace - Pivot from "set of open panes" to a Finder-style miller column stack: TopBar / LeftSidebar / [section → entity → entity ...] / pinned text editor. openPanesStore is now an ordered Column[] with pushFrom / closeFrom / setStack; only one top-level section is rooted at a time. - New entity column panes: Term, Block, Association, Constraint, Requirement, Finding. Click-through navigation truncates deeper columns automatically. - LeftSidebar surfaces a pending-count chip per section (single-glance navigation cue) and spins its analyze ↻ via SVG Spinner whenever the LLM is working — including server-initiated runs caught by the runs poll, not just user-triggered ones. Analyze pipeline + persistence - Unified `concepts` pass (taxonomy + glossary in one LLM call) replaces the two-pass setup. Server still accepts ?section=taxonomy|glossary and normalizes them for back-compat. - model / requirements / detection (assumptions, risks, inconsistencies) + cross-layer validation rules (X1–X4: stale term link, unlinked formalism, undefined linked term, prose-only term). - Persistence: NarrativeDocument, ModelSnapshot, ChangelogEntry, TaxonomyTerm, RequirementEntry, Finding, AnalysisRun. Re-runs MERGE instead of replace: gentle update on existing items, suggested on new, deprecated on missing — same idiom for every artifact kind. User pins preserve "kept" decisions across re-analyses. - Migrations: pivot_text_first, add_requirement_linked_term, term_review_state, review_state_for_reqs_and_findings, add_term_definition_pinned. Concept ↔ ontology integration - linkedTermId on Block / Association / Constraint / Requirement. PromoteToolbar lets the user formalize a concept inline: + Block / + Association / + Constraint / + Requirement, all routed through applyOps so undo/redo and SSE work for free. - decideElement op for in-canvas keep/discard on review-pending model elements. User-authored definitions - TermColumn definition is click-to-edit. Save (Cmd-Enter / blur), Cancel (Esc), Reset to AI suggestion when pinned. - definitionPinned flag on TaxonomyTerm: future Analyze runs leave the user's text alone. setTermDefinition repo function + POST /api/projects/[id]/terms/[termId]/definition endpoint. - mergeTaxonomySuggestion + applyGlossaryDefinitions both pin-aware. UX/UI - StatusChip: single component for all state idioms (suggested, deprecated, accepted, dismissed, resolved, severity, validation code, confidence, warn). Replaces 5+ ad-hoc badge classes. - PaneControls (PaneViewTabs + PaneFilterChip): separates view-mode toggles from filter chips so toggling Pending no longer flips you off the current view. - PaneEmpty: unified empty-state with title + hint + action. - PaneDrawer: collapsible groups for Pending / Discarded review; cards group as Kept (top) → Pending (bottom drawer) → Discarded (Findings only, hidden when empty). Restore action recovers dismissed/resolved findings. - ConceptCard unifies Tree and A–Z views in Concepts; only Tree parents carry the chevron (no empty placeholder offset). - Type + spacing tokens (--text-xs..xl, --space-1..6, --lh-tight/ui/ prose, --radius-*) replace every ad-hoc value. - Buttons standardized to body sans 500 (was a mishmash of mono / display). - Card shells unified across Concepts / Requirements / Findings. Cleanup - Removed: LeftRail, FindingsPanel, IssuesPanel, SocratesDock, ProposalCard, SlashMenu, SlashExtension, slashSuggestion, CanvasHeader, TaxonomyPane, GlossaryPane, TermDetail (popover; now TermColumn). - Section ids in openPanesStore: dropped taxonomy/glossary, added concepts. localStorage migration runs on hydrate. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
56
apps/web/lib/llm/prompts/socrates/analyze-concepts.md
Normal file
56
apps/web/lib/llm/prompts/socrates/analyze-concepts.md
Normal file
@@ -0,0 +1,56 @@
|
||||
You are extracting **concepts** from a product-thinking document — a piece of structured prose written by a product manager describing an idea. The output combines what we used to call "taxonomy" (terms + hierarchy) and "glossary" (definitions) into one pass: a single emit keeps definitions in lockstep with the hierarchy.
|
||||
|
||||
## Goal
|
||||
|
||||
Identify the **distinct concepts** the document refers to — entities, actors, artifacts, processes, attributes — arrange them into a parent/child hierarchy when one is clearly implied, and write a short definition for each.
|
||||
|
||||
## What counts as a term
|
||||
|
||||
- A noun phrase that names a recurring concept ("Tutor", "Lesson Plan", "Skill Tree").
|
||||
- An actor or stakeholder ("Student", "Parent", "Curriculum Designer").
|
||||
- A domain artifact ("Quiz", "Progress Report").
|
||||
- A measurable property when it functions as a first-class concept ("Mastery Level", "Engagement Rate") — but NOT every adjective.
|
||||
|
||||
## What does NOT count
|
||||
|
||||
- Generic English words ("user", "system", "thing") unless the document uses them with a specific meaning.
|
||||
- Adjectives, adverbs, verbs, or transient phrases.
|
||||
- Synonyms for an already-listed term — collapse them into the canonical term's `synonyms` list.
|
||||
|
||||
## Hierarchy rules
|
||||
|
||||
- Use `parentLabel` only when the document explicitly says or strongly implies the child is-a-kind-of the parent (subset, specialization), or part-of-and-defining-feature-of.
|
||||
- Do NOT invent hierarchies that aren't in the document.
|
||||
- A term may have no parent. Most should.
|
||||
|
||||
## Definition rules
|
||||
|
||||
- 1–2 sentences, ≤ 35 words.
|
||||
- Phrased as a noun-phrase definition, not a sentence about the term ("A student-facing agent that …", not "The Tutor is …").
|
||||
- Use only what the document actually says or strongly implies. Do not import outside knowledge.
|
||||
- If the document does not give enough to define the term, return an empty string for that term — do not guess.
|
||||
|
||||
## Output
|
||||
|
||||
Return a single JSON object with this shape:
|
||||
|
||||
```json
|
||||
{
|
||||
"terms": [
|
||||
{
|
||||
"label": "Tutor",
|
||||
"parentLabel": null,
|
||||
"synonyms": ["AI tutor", "tutor agent"],
|
||||
"definition": "A student-facing agent that guides a learner through Socratic questioning toward a curriculum goal."
|
||||
},
|
||||
{
|
||||
"label": "Socratic Tutor",
|
||||
"parentLabel": "Tutor",
|
||||
"synonyms": [],
|
||||
"definition": ""
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
Return ONLY the JSON object. No prose. No code fences.
|
||||
Reference in New Issue
Block a user