episteme 0.2.3

Knowledge graph for software engineering — design patterns, refactorings, and laws for AI agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

<script lang="ts">
  import { createInsight } from '../api/endpoints.ts';
  import { getBaseUrl } from '../stores/connection.svelte.ts';
  import type { CreateInsightResponse } from '../api/types.ts';

  let text = $state('');
  let tagsInput = $state('');
  let submitting = $state(false);
  let result: CreateInsightResponse | null = $state(null);
  let errorMsg: string | null = $state(null);

  let { oncreated }: { oncreated?: (id: string) => void } = $props();

  async function handleSubmit(e: Event) {
    e.preventDefault();
    if (!text.trim() || submitting) return;

    submitting = true;
    errorMsg = null;
    result = null;

    try {
      const tags = tagsInput.trim()
        ? tagsInput.split(',').map(t => t.trim()).filter(t => t.length > 0)
        : undefined;

      const res = await createInsight(getBaseUrl(), text.trim(), tags);
      if (res.error) {
        errorMsg = res.error;
      } else {
        result = res;
        text = '';
        tagsInput = '';
        oncreated?.(res.id);
      }
    } catch (e) {
      errorMsg = e instanceof Error ? e.message : 'Failed to create insight';
    } finally {
      submitting = false;
    }
  }
</script>

<form onsubmit={handleSubmit} class="space-y-3">
  <textarea
    bind:value={text}
    placeholder="Share an insight... e.g., 'We prefer composition over inheritance for payment strategies'"
    rows="3"
    class="w-full bg-[var(--color-surface-container-lowest)] border border-[var(--color-outline-variant)]
      rounded-lg px-3 py-2 text-sm text-[var(--color-on-surface)] placeholder:text-[var(--color-on-surface-variant)]/50
      focus:outline-none focus:border-[var(--color-primary)] resize-none"
  ></textarea>

  <input
    type="text"
    bind:value={tagsInput}
    placeholder="Tags (comma-separated, optional)"
    class="w-full bg-[var(--color-surface-container-lowest)] border border-[var(--color-outline-variant)]
      rounded-lg px-3 py-2 text-sm text-[var(--color-on-surface)] placeholder:text-[var(--color-on-surface-variant)]/50
      focus:outline-none focus:border-[var(--color-primary)]"
  />

  {#if errorMsg}
    <p class="text-xs text-[var(--color-error)]">{errorMsg}</p>
  {/if}

  <button
    type="submit"
    disabled={!text.trim() || submitting}
    class="w-full py-2 rounded-lg text-sm font-bold transition-colors
      bg-[var(--color-primary)] text-[var(--color-on-primary)]
      disabled:opacity-40 disabled:cursor-not-allowed
      hover:bg-[var(--color-primary-container)] hover:text-[var(--color-on-primary-container)]"
  >
    {submitting ? 'Creating...' : 'Add Insight'}
  </button>

  {#if result}
    <div class="mt-3 p-3 rounded-lg bg-[var(--color-surface-container-low)] border border-[var(--color-outline-variant)]/30">
      <p class="text-xs font-bold text-[var(--color-on-surface)] mb-1">
        Created: <span class="font-mono text-[var(--color-insight)]">{result.id}</span>
      </p>
      {#if (result.auto_links?.length ?? 0) > 0}
        <p class="text-[10px] uppercase tracking-wider text-[var(--color-on-surface-variant)] mt-2 mb-1">Auto-detected links</p>
        <div class="flex flex-wrap gap-1">
          {#each result.auto_links as link}
            <span class="text-[10px] px-1.5 py-0.5 rounded
              bg-[var(--color-surface-container-high)] text-[var(--color-on-surface-variant)]">
              {link.entity_id}
              <span class="opacity-60">({link.link_type})</span>
            </span>
          {/each}
        </div>
      {/if}
    </div>
  {/if}
</form>