skillar 0.0.0 → 0.2.1
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/LICENSE +22 -0
- package/README.md +250 -2
- package/dist/analysis/finding.js +190 -0
- package/dist/analysis/tree.js +157 -0
- package/dist/analysis/usage.js +394 -0
- package/dist/api/flows.js +285 -0
- package/dist/api/routes.js +192 -0
- package/dist/api/security.js +86 -0
- package/dist/api/sse.js +55 -0
- package/dist/api/static.js +33 -0
- package/dist/catalog/fields.js +159 -0
- package/dist/catalog/index.js +133 -0
- package/dist/catalog/scanner.js +204 -0
- package/dist/catalog/uri.js +43 -0
- package/dist/catalog/watcher.js +59 -0
- package/dist/cli/config-writer.js +255 -0
- package/dist/cli/doctor.js +268 -0
- package/dist/cli/eval.js +64 -0
- package/dist/cli/export-import.js +68 -0
- package/dist/cli/init.js +272 -0
- package/dist/cli/main.js +165 -0
- package/dist/cli/open.js +24 -0
- package/dist/cli/serve.js +147 -0
- package/dist/config.js +92 -0
- package/dist/dashboard/assets/app.js +354 -0
- package/dist/dashboard/assets/chunk-5DFWNJC2.js +1 -0
- package/dist/dashboard/assets/chunk-S6B2HJQA.js +17 -0
- package/dist/dashboard/assets/styles.css +542 -0
- package/dist/dashboard/index.html +15 -0
- package/dist/fs-watchdog.js +35 -0
- package/dist/herdr/client.js +205 -0
- package/dist/herdr/sync.js +342 -0
- package/dist/ingest/attribution.js +80 -0
- package/dist/ingest/hooks.js +168 -0
- package/dist/ingest/identity.js +4 -0
- package/dist/ingest/mcp-recorder.js +41 -0
- package/dist/ingest/otlp-traces.js +106 -0
- package/dist/ingest/otlp.js +314 -0
- package/dist/ingest/pipeline.js +119 -0
- package/dist/ingest/redact.js +36 -0
- package/dist/ingest/runtimes.js +25 -0
- package/dist/mcp/dispatch.js +54 -0
- package/dist/mcp/http.js +112 -0
- package/dist/mcp/legacy.js +61 -0
- package/dist/mcp/pagination.js +17 -0
- package/dist/mcp/protocol.js +121 -0
- package/dist/mcp/skills-extension.js +77 -0
- package/dist/mcp/stdio-proxy.js +108 -0
- package/dist/mcp/tools.js +59 -0
- package/dist/packs/claude-code.js +176 -0
- package/dist/packs/codex.js +207 -0
- package/dist/packs/cursor.js +97 -0
- package/dist/packs/gajae.js +7 -0
- package/dist/packs/gemini.js +90 -0
- package/dist/packs/json-config.js +55 -0
- package/dist/packs/omo.js +154 -0
- package/dist/packs/openclaw.js +132 -0
- package/dist/packs/registry.js +13 -0
- package/dist/search/fts.js +61 -0
- package/dist/search/fusion.js +50 -0
- package/dist/search/guidance.js +7 -0
- package/dist/search/index.js +74 -0
- package/dist/search/lexical.js +69 -0
- package/dist/server.js +267 -0
- package/dist/store/automation.js +18 -0
- package/dist/store/db.js +134 -0
- package/dist/store/execution.js +157 -0
- package/dist/store/export.js +269 -0
- package/dist/store/index.js +14 -0
- package/dist/store/migrations/002_tracing.sql +94 -0
- package/dist/store/migrations/003_tracing_indexes.sql +11 -0
- package/dist/store/migrations/004_load_reconciliation.sql +50 -0
- package/dist/store/migrations/005_execution_boundaries.sql +6 -0
- package/dist/store/migrations/006_recording_order.sql +72 -0
- package/dist/store/queries.js +643 -0
- package/dist/store/schema.sql +96 -0
- package/dist/store/workflow.js +250 -0
- package/dist/store/writes.js +315 -0
- package/dist/types.js +1 -0
- package/dist/version.js +19 -0
- package/dist/workflow/compare.js +68 -0
- package/dist/workflow/routes.js +100 -0
- package/dist/workflow/spec.js +40 -0
- package/docs/execution-ownership.md +98 -0
- package/docs/mcp-conformance.md +156 -0
- package/docs/skill-tracing.md +294 -0
- package/package.json +46 -3
- package/packs/claude-code/README.md +5 -0
- package/packs/claude-code/settings.template.json +34 -0
- package/packs/codex/README.md +8 -0
- package/packs/codex/config.template.toml +12 -0
- package/packs/cursor/hooks.example.json +8 -0
- package/packs/cursor/mcp.example.json +8 -0
- package/packs/gajae/extension/discovery.md +5 -0
- package/packs/gajae/extension/index.js +52 -0
- package/packs/gemini/settings.example.json +16 -0
- package/packs/hook-post.mjs +37 -0
- package/packs/omo/extension/discovery.md +5 -0
- package/packs/omo/extension/index.js +52 -0
- package/packs/openclaw/.codex-plugin/plugin.json +11 -0
- package/packs/openclaw/.mcp.json +12 -0
- package/packs/openclaw/hooks/skillar-discovery/HOOK.md +8 -0
- package/packs/openclaw/hooks/skillar-discovery/handler.js +30 -0
- package/packs/openclaw/index.mjs +55 -0
- package/packs/openclaw/openclaw.plugin.json +22 -0
- package/packs/openclaw/package.json +11 -0
- package/packs/openclaw/skillar.json +1 -0
- package/src/store/migrations/002_tracing.sql +94 -0
- package/src/store/migrations/003_tracing_indexes.sql +11 -0
- package/src/store/migrations/004_load_reconciliation.sql +50 -0
- package/src/store/migrations/005_execution_boundaries.sql +6 -0
- package/src/store/migrations/006_recording_order.sql +72 -0
- package/src/store/schema.sql +96 -0
- package/src/store/task-types.json +15 -0
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { join } from "node:path";
|
|
2
|
+
|
|
3
|
+
export const marker = "<skillar-discovery>";
|
|
4
|
+
export const guidance = `${marker}
|
|
5
|
+
skillar searches skills on this machine through MCP 2026-07-28.
|
|
6
|
+
Before substantive work on a new actionable task, use the skillar search_skills tool
|
|
7
|
+
(MCP server "skillar") with 2-5 subject/outcome terms. Search is not activation:
|
|
8
|
+
check relevance and invocation, then read a chosen SKILL.md URI using the host's
|
|
9
|
+
resource reader (resources/read) on this server. Resolve relative references
|
|
10
|
+
against the skill root, the directory containing SKILL.md, and read supporting
|
|
11
|
+
files only as needed. Reads do not activate skills or grant permissions; the host
|
|
12
|
+
owns verification and approval. If results are empty or unrelated, retry once with
|
|
13
|
+
a shorter subject, then proceed. Greetings and unchanged-task continuations need no
|
|
14
|
+
new search. Respect a user ban on skill lookup. If the tools are unavailable, say so
|
|
15
|
+
briefly and continue.
|
|
16
|
+
</skillar-discovery>`;
|
|
17
|
+
|
|
18
|
+
export default function handler(event) {
|
|
19
|
+
if (event.type !== "agent" || event.action !== "bootstrap") return;
|
|
20
|
+
const files = event.context?.bootstrapFiles;
|
|
21
|
+
if (!Array.isArray(files)) return;
|
|
22
|
+
if (files.some(file => (file.content?.includes(marker) || file.content?.includes("<gisool-discovery>") || file.content?.includes("<gisul-discovery>")))) return;
|
|
23
|
+
const index = files.findIndex(file => file.name === "AGENTS.md");
|
|
24
|
+
if (index >= 0) {
|
|
25
|
+
const file = files[index];
|
|
26
|
+
files[index] = { ...file, content: [file.content, guidance].filter(Boolean).join("\n\n"), missing: false };
|
|
27
|
+
} else if (event.context.workspaceDir) {
|
|
28
|
+
files.push({ name: "AGENTS.md", path: join(event.context.workspaceDir, "AGENTS.md"), content: guidance, missing: false });
|
|
29
|
+
}
|
|
30
|
+
}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
// skillar capture plugin: forwards each agent run's prompt to the local skillar daemon.
|
|
2
|
+
// Needs plugins.entries.skillar.hooks.allowConversationAccess: true in the OpenClaw config.
|
|
3
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
4
|
+
import { homedir } from "node:os";
|
|
5
|
+
import { join } from "node:path";
|
|
6
|
+
|
|
7
|
+
function resolveStateHome(env) {
|
|
8
|
+
const home = env.HOME || homedir();
|
|
9
|
+
const preferred = join(home, ".skillar"), legacy = join(home, ".gisool");
|
|
10
|
+
if (["config.json", "token", "skillar.db", "gisool.db"].some(file => existsSync(join(preferred, file)))) return preferred;
|
|
11
|
+
return existsSync(legacy) ? legacy : preferred;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
const here = new URL(".", import.meta.url);
|
|
16
|
+
|
|
17
|
+
function loadPort(env) {
|
|
18
|
+
if ((env.SKILLAR_PORT ?? env.GISOOL_PORT)) return Number((env.SKILLAR_PORT ?? env.GISOOL_PORT));
|
|
19
|
+
try {
|
|
20
|
+
return Number(JSON.parse(readFileSync(new URL("skillar.json", here), "utf8")).port);
|
|
21
|
+
} catch {
|
|
22
|
+
return NaN;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/** Fire-and-forget POST; never throws, never awaited by the hook. */
|
|
27
|
+
export function forward(payload, env = process.env) {
|
|
28
|
+
try {
|
|
29
|
+
const port = loadPort(env);
|
|
30
|
+
const token = readFileSync(join((env.SKILLAR_HOME || env.GISOOL_HOME) || resolveStateHome(env), "token"), "utf8").trim();
|
|
31
|
+
if (!Number.isInteger(port) || !token) return;
|
|
32
|
+
fetch(`http://127.0.0.1:${port}/ingest/hook/openclaw`, {
|
|
33
|
+
method: "POST",
|
|
34
|
+
headers: { "content-type": "application/json", authorization: `Bearer ${token}` },
|
|
35
|
+
body: JSON.stringify(payload),
|
|
36
|
+
signal: AbortSignal.timeout(2000),
|
|
37
|
+
}).catch(() => {});
|
|
38
|
+
} catch {
|
|
39
|
+
// capture must never affect the agent run
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
export function register(api, env = process.env) {
|
|
44
|
+
if (typeof api.on === "function") {
|
|
45
|
+
api.on("before_agent_run", (event, ctx) => {
|
|
46
|
+
forward({ event: "before_agent_run", prompt: event?.prompt ?? null, sessionKey: ctx?.sessionKey, sessionId: ctx?.sessionId }, env);
|
|
47
|
+
});
|
|
48
|
+
} else if (typeof api.registerHook === "function") {
|
|
49
|
+
api.registerHook("message:received", (event) => {
|
|
50
|
+
forward({ event: "message_received", via: "message_received", prompt: event?.context?.content ?? null, sessionKey: event?.sessionKey }, env);
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
export default { id: "skillar", name: "skillar", description: "Capture prompts for the local skillar skill router.", register };
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "skillar",
|
|
3
|
+
"name": "skillar",
|
|
4
|
+
"description": "Capture OpenClaw prompts for the local skillar skill router.",
|
|
5
|
+
"activation": {
|
|
6
|
+
"onStartup": true
|
|
7
|
+
},
|
|
8
|
+
"configSchema": {
|
|
9
|
+
"type": "object",
|
|
10
|
+
"additionalProperties": false
|
|
11
|
+
},
|
|
12
|
+
"mcpServers": {
|
|
13
|
+
"skillar": {
|
|
14
|
+
"transport": "stdio",
|
|
15
|
+
"command": "__COMMAND__",
|
|
16
|
+
"args": "__ARGS__",
|
|
17
|
+
"env": {
|
|
18
|
+
"SKILLAR_HOME": "__SKILLAR_HOME__"
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{ "port": "__PORT__" }
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
-- skillar store migration 2: tracing keys on events, herdr topology and workflow specs (user_version 1 -> 2).
|
|
2
|
+
-- db.ts runs this inside a transaction and sets user_version afterwards, so this file sets no PRAGMA.
|
|
3
|
+
|
|
4
|
+
ALTER TABLE events ADD COLUMN source_key TEXT;
|
|
5
|
+
ALTER TABLE events ADD COLUMN turn_key TEXT;
|
|
6
|
+
ALTER TABLE events ADD COLUMN call_id TEXT;
|
|
7
|
+
ALTER TABLE events ADD COLUMN span_id TEXT;
|
|
8
|
+
|
|
9
|
+
-- source_key identifies the agent record an event was derived from, so replaying a batch stores nothing new.
|
|
10
|
+
CREATE UNIQUE INDEX IF NOT EXISTS events_source_key ON events(source_key) WHERE source_key IS NOT NULL;
|
|
11
|
+
CREATE INDEX IF NOT EXISTS events_turn ON events(session_id, turn_key);
|
|
12
|
+
CREATE INDEX IF NOT EXISTS events_call ON events(call_id) WHERE call_id IS NOT NULL;
|
|
13
|
+
|
|
14
|
+
CREATE TABLE IF NOT EXISTS otel_spans (
|
|
15
|
+
trace_id TEXT NOT NULL,
|
|
16
|
+
span_id TEXT NOT NULL,
|
|
17
|
+
parent_span_id TEXT,
|
|
18
|
+
name TEXT NOT NULL,
|
|
19
|
+
runtime TEXT NOT NULL,
|
|
20
|
+
conversation_id TEXT,
|
|
21
|
+
turn_key TEXT,
|
|
22
|
+
call_id TEXT,
|
|
23
|
+
start_ms INTEGER,
|
|
24
|
+
end_ms INTEGER,
|
|
25
|
+
received_at INTEGER NOT NULL,
|
|
26
|
+
PRIMARY KEY (trace_id, span_id)
|
|
27
|
+
);
|
|
28
|
+
CREATE INDEX IF NOT EXISTS otel_spans_call ON otel_spans(call_id);
|
|
29
|
+
CREATE INDEX IF NOT EXISTS otel_spans_turn ON otel_spans(turn_key);
|
|
30
|
+
|
|
31
|
+
CREATE TABLE IF NOT EXISTS herdr_workspaces (
|
|
32
|
+
id TEXT PRIMARY KEY,
|
|
33
|
+
label TEXT,
|
|
34
|
+
created_ms INTEGER,
|
|
35
|
+
closed_ms INTEGER
|
|
36
|
+
);
|
|
37
|
+
|
|
38
|
+
CREATE TABLE IF NOT EXISTS herdr_tabs (
|
|
39
|
+
id TEXT PRIMARY KEY,
|
|
40
|
+
workspace_id TEXT,
|
|
41
|
+
label TEXT,
|
|
42
|
+
created_ms INTEGER,
|
|
43
|
+
closed_ms INTEGER
|
|
44
|
+
);
|
|
45
|
+
|
|
46
|
+
CREATE TABLE IF NOT EXISTS herdr_panes (
|
|
47
|
+
id TEXT PRIMARY KEY,
|
|
48
|
+
workspace_id TEXT,
|
|
49
|
+
tab_id TEXT,
|
|
50
|
+
label TEXT,
|
|
51
|
+
cwd TEXT,
|
|
52
|
+
created_ms INTEGER,
|
|
53
|
+
closed_ms INTEGER
|
|
54
|
+
);
|
|
55
|
+
|
|
56
|
+
-- session_id stays NULL until a skillar session matches the reported agent session value.
|
|
57
|
+
CREATE TABLE IF NOT EXISTS pane_sessions (
|
|
58
|
+
pane_id TEXT NOT NULL,
|
|
59
|
+
agent TEXT,
|
|
60
|
+
source TEXT,
|
|
61
|
+
agent_session_value TEXT NOT NULL,
|
|
62
|
+
session_id TEXT REFERENCES sessions(id),
|
|
63
|
+
first_seen_ms INTEGER,
|
|
64
|
+
last_seen_ms INTEGER,
|
|
65
|
+
PRIMARY KEY (pane_id, agent_session_value)
|
|
66
|
+
);
|
|
67
|
+
|
|
68
|
+
CREATE TABLE IF NOT EXISTS workflow_specs (
|
|
69
|
+
id TEXT PRIMARY KEY,
|
|
70
|
+
name TEXT NOT NULL,
|
|
71
|
+
version INTEGER NOT NULL,
|
|
72
|
+
body_json TEXT NOT NULL,
|
|
73
|
+
digest TEXT NOT NULL,
|
|
74
|
+
created_ms INTEGER NOT NULL,
|
|
75
|
+
UNIQUE (name, version)
|
|
76
|
+
);
|
|
77
|
+
|
|
78
|
+
CREATE TABLE IF NOT EXISTS flows (
|
|
79
|
+
id TEXT PRIMARY KEY,
|
|
80
|
+
workspace_id TEXT,
|
|
81
|
+
tab_id TEXT,
|
|
82
|
+
spec_id TEXT REFERENCES workflow_specs(id),
|
|
83
|
+
label TEXT,
|
|
84
|
+
registered_ms INTEGER,
|
|
85
|
+
ended_ms INTEGER
|
|
86
|
+
);
|
|
87
|
+
|
|
88
|
+
CREATE TABLE IF NOT EXISTS flow_steps (
|
|
89
|
+
flow_id TEXT NOT NULL REFERENCES flows(id),
|
|
90
|
+
pane_id TEXT NOT NULL,
|
|
91
|
+
step_id TEXT NOT NULL,
|
|
92
|
+
registered_ms INTEGER,
|
|
93
|
+
PRIMARY KEY (flow_id, pane_id)
|
|
94
|
+
);
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
-- Bounded pane lifetime searches and session-local span lookups.
|
|
2
|
+
ALTER TABLE herdr_panes ADD COLUMN agent TEXT;
|
|
3
|
+
ALTER TABLE herdr_panes ADD COLUMN last_seen_ms INTEGER;
|
|
4
|
+
UPDATE herdr_panes SET last_seen_ms = COALESCE(closed_ms, created_ms);
|
|
5
|
+
CREATE INDEX pane_sessions_session ON pane_sessions(session_id);
|
|
6
|
+
CREATE INDEX pane_sessions_pending ON pane_sessions(session_id) WHERE session_id IS NULL;
|
|
7
|
+
CREATE INDEX herdr_panes_cwd ON herdr_panes(cwd, created_ms);
|
|
8
|
+
CREATE INDEX herdr_panes_closed ON herdr_panes(closed_ms);
|
|
9
|
+
CREATE INDEX herdr_panes_seen ON herdr_panes(last_seen_ms);
|
|
10
|
+
CREATE INDEX sessions_cwd_started ON sessions(cwd, started_at);
|
|
11
|
+
CREATE INDEX otel_spans_conversation ON otel_spans(conversation_id);
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
-- Candidate membership is an index over portable events.data_json, not new captured text.
|
|
2
|
+
-- Backfill the one proven match on stores that resolved loads before this migration.
|
|
3
|
+
UPDATE events SET data_json = json_set(data_json, '$.attributionMatches', json_array(session_id))
|
|
4
|
+
WHERE source = 'mcp' AND kind = 'load' AND attribution_method = 'trace_handle'
|
|
5
|
+
AND json_extract(data_json, '$.attributionBasis') = 'tool_call_uri'
|
|
6
|
+
AND json_type(data_json, '$.attributionMatches') IS NULL;
|
|
7
|
+
|
|
8
|
+
CREATE INDEX events_pending_load_ts ON events(ts)
|
|
9
|
+
WHERE source = 'mcp' AND kind = 'load' AND session_id = 'unattributed' AND attribution_reason = 'ambiguous';
|
|
10
|
+
CREATE INDEX events_reconcile_load_uri ON events(runtime, skill_uri, ts)
|
|
11
|
+
WHERE source = 'mcp' AND kind = 'load';
|
|
12
|
+
CREATE INDEX events_uri_tools ON events(runtime, session_id, ts)
|
|
13
|
+
WHERE source = 'otel' AND kind = 'tool_call' AND session_id != 'unattributed'
|
|
14
|
+
AND json_extract(data_json, '$.success') IS NOT 0;
|
|
15
|
+
CREATE INDEX sessions_runtime_started ON sessions(runtime, started_at);
|
|
16
|
+
|
|
17
|
+
CREATE TABLE load_candidates (
|
|
18
|
+
load_id TEXT NOT NULL REFERENCES events(id) ON DELETE CASCADE,
|
|
19
|
+
session_id TEXT NOT NULL,
|
|
20
|
+
ts INTEGER NOT NULL,
|
|
21
|
+
PRIMARY KEY (load_id, session_id)
|
|
22
|
+
) WITHOUT ROWID;
|
|
23
|
+
CREATE INDEX load_candidates_session_ts ON load_candidates(session_id, ts, load_id);
|
|
24
|
+
|
|
25
|
+
-- Old history imports may have no candidate snapshot. Reconstruct at the event's timestamp,
|
|
26
|
+
-- exactly once on insert, not on every report. Both branches use session/time indexes.
|
|
27
|
+
CREATE VIEW load_candidate_rows AS
|
|
28
|
+
SELECT e.id AS load_id, j.value AS session_id, e.ts
|
|
29
|
+
FROM events e, json_each(COALESCE(json_extract(e.data_json, '$.attributionCandidates'),
|
|
30
|
+
(SELECT json_group_array(s.id) FROM sessions s
|
|
31
|
+
WHERE s.runtime = e.runtime AND s.started_at <= e.ts AND (s.ended_at IS NULL OR s.ended_at >= e.ts)
|
|
32
|
+
AND MAX(s.started_at, COALESCE((SELECT MAX(a.ts) FROM events a
|
|
33
|
+
WHERE a.session_id = s.id AND a.ts <= e.ts), s.started_at)) >= e.ts - 120000))) j
|
|
34
|
+
WHERE e.source = 'mcp' AND e.kind = 'load' AND j.type = 'text'
|
|
35
|
+
AND ((e.session_id = 'unattributed' AND e.attribution_reason = 'ambiguous')
|
|
36
|
+
OR (e.attribution_method = 'trace_handle' AND json_extract(e.data_json, '$.attributionBasis') = 'tool_call_uri'));
|
|
37
|
+
|
|
38
|
+
INSERT INTO load_candidates SELECT * FROM load_candidate_rows;
|
|
39
|
+
CREATE TRIGGER events_load_candidates_insert AFTER INSERT ON events
|
|
40
|
+
WHEN NEW.source = 'mcp' AND NEW.kind = 'load'
|
|
41
|
+
BEGIN
|
|
42
|
+
INSERT INTO load_candidates SELECT * FROM load_candidate_rows WHERE load_id = NEW.id;
|
|
43
|
+
END;
|
|
44
|
+
CREATE TRIGGER events_load_candidates_update AFTER UPDATE OF data_json ON events
|
|
45
|
+
WHEN NEW.source = 'mcp' AND NEW.kind = 'load'
|
|
46
|
+
AND json_extract(NEW.data_json, '$.attributionCandidates') IS NOT json_extract(OLD.data_json, '$.attributionCandidates')
|
|
47
|
+
BEGIN
|
|
48
|
+
DELETE FROM load_candidates WHERE load_id = NEW.id;
|
|
49
|
+
INSERT INTO load_candidates SELECT * FROM load_candidate_rows WHERE load_id = NEW.id;
|
|
50
|
+
END;
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
-- Identity snapshots, not SQLite rowids: history import and VACUUM may reorder rows.
|
|
2
|
+
-- NULL means this boundary predates recording; never reconstruct a historical cut.
|
|
3
|
+
ALTER TABLE flows ADD COLUMN start_event_ids_json TEXT;
|
|
4
|
+
ALTER TABLE flows ADD COLUMN end_event_ids_json TEXT;
|
|
5
|
+
ALTER TABLE flows ADD COLUMN end_sessions_json TEXT;
|
|
6
|
+
ALTER TABLE flows ADD COLUMN end_spans_json TEXT;
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
-- A recording domain names a database lineage, not an ordering of UUIDs.
|
|
2
|
+
-- Keep its high-water mark independently of retained observations and rowids.
|
|
3
|
+
CREATE TABLE recording_clock (
|
|
4
|
+
singleton INTEGER PRIMARY KEY CHECK (singleton = 1),
|
|
5
|
+
domain TEXT NOT NULL,
|
|
6
|
+
position INTEGER NOT NULL CHECK (position BETWEEN 0 AND 9007199254740991)
|
|
7
|
+
);
|
|
8
|
+
INSERT INTO recording_clock VALUES (1, lower(hex(randomblob(16))), 0);
|
|
9
|
+
-- Outer INSERT OR IGNORE must not suppress exhaustion and reuse the last mark.
|
|
10
|
+
CREATE TRIGGER recording_clock_range BEFORE UPDATE OF position ON recording_clock
|
|
11
|
+
WHEN typeof(NEW.position) <> 'integer' OR NEW.position < OLD.position OR NEW.position > 9007199254740991
|
|
12
|
+
BEGIN
|
|
13
|
+
SELECT RAISE(ABORT, 'recording clock exhausted or moved backwards');
|
|
14
|
+
END;
|
|
15
|
+
|
|
16
|
+
ALTER TABLE events ADD COLUMN recording_orders_json TEXT NOT NULL DEFAULT '{}';
|
|
17
|
+
ALTER TABLE otel_spans ADD COLUMN recording_orders_json TEXT NOT NULL DEFAULT '{}';
|
|
18
|
+
ALTER TABLE sessions ADD COLUMN end_orders_json TEXT NOT NULL DEFAULT '{}';
|
|
19
|
+
ALTER TABLE flows ADD COLUMN start_order_domain TEXT;
|
|
20
|
+
ALTER TABLE flows ADD COLUMN start_order INTEGER;
|
|
21
|
+
ALTER TABLE flows ADD COLUMN end_order_domain TEXT;
|
|
22
|
+
ALTER TABLE flows ADD COLUMN end_order INTEGER;
|
|
23
|
+
|
|
24
|
+
-- Old rows precede future cuts in this new domain. This does NOT reconstruct old
|
|
25
|
+
-- flow cuts or order the old rows against each other.
|
|
26
|
+
UPDATE events SET recording_orders_json = (SELECT json_object(domain, 0) FROM recording_clock);
|
|
27
|
+
UPDATE otel_spans SET recording_orders_json = (SELECT json_object(domain, 0) FROM recording_clock);
|
|
28
|
+
UPDATE sessions SET end_orders_json = (SELECT json_object(domain, 0) FROM recording_clock) WHERE ended_at IS NOT NULL;
|
|
29
|
+
|
|
30
|
+
-- Source-domain marks survive import; add local arrival order without replacing
|
|
31
|
+
-- a known mark when restoring history from this same lineage. Advance past it.
|
|
32
|
+
CREATE TRIGGER events_recording_insert AFTER INSERT ON events BEGIN
|
|
33
|
+
UPDATE recording_clock SET position = MAX(position + 1,
|
|
34
|
+
COALESCE(json_extract(NEW.recording_orders_json, '$."' || domain || '"'), 0));
|
|
35
|
+
UPDATE events SET recording_orders_json = (SELECT
|
|
36
|
+
json_insert(NEW.recording_orders_json, '$."' || domain || '"', position) FROM recording_clock)
|
|
37
|
+
WHERE id = NEW.id;
|
|
38
|
+
END;
|
|
39
|
+
|
|
40
|
+
CREATE TRIGGER spans_recording_insert AFTER INSERT ON otel_spans BEGIN
|
|
41
|
+
UPDATE recording_clock SET position = MAX(position + 1,
|
|
42
|
+
COALESCE(json_extract(NEW.recording_orders_json, '$."' || domain || '"'), 0));
|
|
43
|
+
UPDATE otel_spans SET recording_orders_json = (SELECT
|
|
44
|
+
json_insert(NEW.recording_orders_json, '$."' || domain || '"', position) FROM recording_clock)
|
|
45
|
+
WHERE trace_id = NEW.trace_id AND span_id = NEW.span_id;
|
|
46
|
+
END;
|
|
47
|
+
|
|
48
|
+
-- putSpans ignores replays. If stored facts are corrected, their previous order
|
|
49
|
+
-- cannot certify the corrected facts at a boundary that has already closed.
|
|
50
|
+
CREATE TRIGGER spans_recording_update AFTER UPDATE OF
|
|
51
|
+
parent_span_id, name, runtime, conversation_id, turn_key, call_id, start_ms, end_ms ON otel_spans
|
|
52
|
+
WHEN OLD.parent_span_id IS NOT NEW.parent_span_id OR OLD.name IS NOT NEW.name
|
|
53
|
+
OR OLD.runtime IS NOT NEW.runtime OR OLD.conversation_id IS NOT NEW.conversation_id
|
|
54
|
+
OR OLD.turn_key IS NOT NEW.turn_key OR OLD.call_id IS NOT NEW.call_id
|
|
55
|
+
OR OLD.start_ms IS NOT NEW.start_ms OR OLD.end_ms IS NOT NEW.end_ms
|
|
56
|
+
BEGIN
|
|
57
|
+
UPDATE recording_clock SET position = position + 1;
|
|
58
|
+
UPDATE otel_spans SET recording_orders_json = (SELECT json_object(domain, position) FROM recording_clock)
|
|
59
|
+
WHERE trace_id = NEW.trace_id AND span_id = NEW.span_id;
|
|
60
|
+
END;
|
|
61
|
+
|
|
62
|
+
CREATE TRIGGER sessions_end_insert AFTER INSERT ON sessions WHEN NEW.ended_at IS NOT NULL BEGIN
|
|
63
|
+
UPDATE recording_clock SET position = MAX(position + 1,
|
|
64
|
+
COALESCE(json_extract(NEW.end_orders_json, '$."' || domain || '"'), 0));
|
|
65
|
+
UPDATE sessions SET end_orders_json = (SELECT
|
|
66
|
+
json_insert(NEW.end_orders_json, '$."' || domain || '"', position) FROM recording_clock)
|
|
67
|
+
WHERE id = NEW.id;
|
|
68
|
+
END;
|
|
69
|
+
CREATE TRIGGER sessions_end_update AFTER UPDATE OF ended_at ON sessions WHEN OLD.ended_at IS NOT NEW.ended_at BEGIN
|
|
70
|
+
UPDATE recording_clock SET position = position + 1;
|
|
71
|
+
UPDATE sessions SET end_orders_json = (SELECT json_object(domain, position) FROM recording_clock) WHERE id = NEW.id;
|
|
72
|
+
END;
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
-- skillar store schema, user_version 1
|
|
2
|
+
CREATE TABLE IF NOT EXISTS meta (
|
|
3
|
+
key TEXT PRIMARY KEY,
|
|
4
|
+
value TEXT
|
|
5
|
+
);
|
|
6
|
+
|
|
7
|
+
CREATE TABLE IF NOT EXISTS skills (
|
|
8
|
+
uri TEXT PRIMARY KEY,
|
|
9
|
+
root_id TEXT NOT NULL,
|
|
10
|
+
name TEXT NOT NULL,
|
|
11
|
+
description TEXT NOT NULL DEFAULT '',
|
|
12
|
+
tags_json TEXT NOT NULL DEFAULT '[]',
|
|
13
|
+
when_to_use TEXT,
|
|
14
|
+
examples_json TEXT NOT NULL DEFAULT '[]',
|
|
15
|
+
aliases_ko_json TEXT NOT NULL DEFAULT '[]',
|
|
16
|
+
group_id TEXT,
|
|
17
|
+
group_stage TEXT,
|
|
18
|
+
invocation TEXT NOT NULL DEFAULT 'automatic',
|
|
19
|
+
body_head TEXT NOT NULL DEFAULT '',
|
|
20
|
+
digest TEXT NOT NULL,
|
|
21
|
+
manifest_digest TEXT NOT NULL,
|
|
22
|
+
resources_json TEXT NOT NULL DEFAULT '[]',
|
|
23
|
+
mtime_ms INTEGER NOT NULL DEFAULT 0,
|
|
24
|
+
removed_at INTEGER
|
|
25
|
+
);
|
|
26
|
+
|
|
27
|
+
-- uri is stored UNINDEXED so rows join back to skills(uri).
|
|
28
|
+
CREATE VIRTUAL TABLE IF NOT EXISTS skills_fts USING fts5(
|
|
29
|
+
uri UNINDEXED,
|
|
30
|
+
name,
|
|
31
|
+
description,
|
|
32
|
+
when_to_use,
|
|
33
|
+
examples,
|
|
34
|
+
aliases_ko,
|
|
35
|
+
body_head,
|
|
36
|
+
tokenize = 'trigram'
|
|
37
|
+
);
|
|
38
|
+
|
|
39
|
+
CREATE TABLE IF NOT EXISTS sessions (
|
|
40
|
+
id TEXT PRIMARY KEY,
|
|
41
|
+
runtime TEXT NOT NULL,
|
|
42
|
+
runtime_session_id TEXT,
|
|
43
|
+
conversation_id TEXT,
|
|
44
|
+
client_name TEXT,
|
|
45
|
+
cwd TEXT,
|
|
46
|
+
started_at INTEGER NOT NULL,
|
|
47
|
+
ended_at INTEGER,
|
|
48
|
+
first_prompt TEXT
|
|
49
|
+
);
|
|
50
|
+
CREATE INDEX IF NOT EXISTS sessions_runtime_session ON sessions(runtime, runtime_session_id);
|
|
51
|
+
CREATE INDEX IF NOT EXISTS sessions_runtime_conversation ON sessions(runtime, conversation_id);
|
|
52
|
+
CREATE INDEX IF NOT EXISTS sessions_started ON sessions(started_at);
|
|
53
|
+
|
|
54
|
+
CREATE TABLE IF NOT EXISTS events (
|
|
55
|
+
id TEXT PRIMARY KEY,
|
|
56
|
+
ts INTEGER NOT NULL,
|
|
57
|
+
kind TEXT NOT NULL,
|
|
58
|
+
source TEXT NOT NULL,
|
|
59
|
+
session_id TEXT NOT NULL,
|
|
60
|
+
attribution_method TEXT NOT NULL,
|
|
61
|
+
attribution_reason TEXT,
|
|
62
|
+
runtime TEXT NOT NULL,
|
|
63
|
+
trace_id TEXT,
|
|
64
|
+
load_id TEXT,
|
|
65
|
+
skill_uri TEXT,
|
|
66
|
+
tool_use_id TEXT,
|
|
67
|
+
text TEXT,
|
|
68
|
+
text_digest TEXT,
|
|
69
|
+
text_length INTEGER,
|
|
70
|
+
data_json TEXT NOT NULL DEFAULT '{}'
|
|
71
|
+
);
|
|
72
|
+
CREATE INDEX IF NOT EXISTS events_session_ts ON events(session_id, ts);
|
|
73
|
+
CREATE INDEX IF NOT EXISTS events_ts ON events(ts);
|
|
74
|
+
CREATE INDEX IF NOT EXISTS events_trace ON events(trace_id);
|
|
75
|
+
CREATE INDEX IF NOT EXISTS events_skill ON events(skill_uri);
|
|
76
|
+
CREATE INDEX IF NOT EXISTS events_tool_use ON events(tool_use_id);
|
|
77
|
+
|
|
78
|
+
CREATE TABLE IF NOT EXISTS loads (
|
|
79
|
+
load_id TEXT PRIMARY KEY,
|
|
80
|
+
trace_id TEXT,
|
|
81
|
+
uri TEXT NOT NULL,
|
|
82
|
+
manifest_digest TEXT NOT NULL,
|
|
83
|
+
resources_json TEXT NOT NULL DEFAULT '[]',
|
|
84
|
+
created_at INTEGER NOT NULL
|
|
85
|
+
);
|
|
86
|
+
CREATE INDEX IF NOT EXISTS loads_uri_created ON loads(uri, created_at);
|
|
87
|
+
|
|
88
|
+
CREATE TABLE IF NOT EXISTS eval_cases (
|
|
89
|
+
id TEXT PRIMARY KEY,
|
|
90
|
+
query TEXT NOT NULL,
|
|
91
|
+
expected_uri TEXT,
|
|
92
|
+
from_trace_id TEXT,
|
|
93
|
+
created_at INTEGER NOT NULL
|
|
94
|
+
);
|
|
95
|
+
|
|
96
|
+
PRAGMA user_version = 1;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
[
|
|
2
|
+
{ "taskType": "code-review", "anyTags": ["code-review", "review", "pr"], "anyGroup": ["code-review", "review"], "anyNameKeywords": ["review", "reviewer", "pr-review", "lint"], "anyPromptKeywords": ["code review", "review this", "pull request", "리뷰", "코드 검토", "PR 검토"] },
|
|
3
|
+
{ "taskType": "debugging", "anyTags": ["debugging", "debug", "bugfix"], "anyGroup": ["debugging"], "anyNameKeywords": ["debug", "debugging", "bug", "bugfix", "crash", "troubleshoot"], "anyPromptKeywords": ["debug", "bug", "crash", "stack trace", "error", "디버그", "디버깅", "버그", "에러", "오류"] },
|
|
4
|
+
{ "taskType": "testing", "anyTags": ["testing", "test", "qa"], "anyGroup": ["testing", "qa"], "anyNameKeywords": ["test", "tests", "testing", "qa", "e2e", "tdd"], "anyPromptKeywords": ["write tests", "unit test", "test case", "테스트", "QA"] },
|
|
5
|
+
{ "taskType": "database", "anyTags": ["database", "sql", "db"], "anyGroup": ["database", "db"], "anyNameKeywords": ["database", "db", "sql", "query", "postgres", "mysql", "sqlite", "migration"], "anyPromptKeywords": ["sql", "database", "query", "schema", "데이터베이스", "쿼리", "디비"] },
|
|
6
|
+
{ "taskType": "api", "anyTags": ["api", "rest", "graphql"], "anyGroup": ["api"], "anyNameKeywords": ["api", "rest", "graphql", "openapi", "endpoint", "grpc"], "anyPromptKeywords": ["api", "endpoint", "graphql", "rest api", "엔드포인트"] },
|
|
7
|
+
{ "taskType": "frontend-ui", "anyTags": ["frontend", "ui", "ux", "css"], "anyGroup": ["frontend", "frontend-ui", "design"], "anyNameKeywords": ["frontend", "ui", "ux", "css", "react", "component", "design", "layout"], "anyPromptKeywords": ["frontend", "ui", "css", "component", "layout", "프론트", "화면", "디자인", "컴포넌트"] },
|
|
8
|
+
{ "taskType": "docs-writing", "anyTags": ["docs", "writing", "documentation"], "anyGroup": ["docs", "writing"], "anyNameKeywords": ["docs", "doc", "writing", "readme", "documentation", "write", "copy"], "anyPromptKeywords": ["readme", "documentation", "write a doc", "문서", "글쓰기", "작성해"] },
|
|
9
|
+
{ "taskType": "research", "anyTags": ["research"], "anyGroup": ["research"], "anyNameKeywords": ["research", "investigate", "survey", "search"], "anyPromptKeywords": ["research", "investigate", "compare", "리서치", "조사", "찾아봐"] },
|
|
10
|
+
{ "taskType": "release-deploy", "anyTags": ["release", "deploy", "ci"], "anyGroup": ["release", "deploy", "release-deploy"], "anyNameKeywords": ["release", "deploy", "deployment", "ship", "publish", "changelog", "ci"], "anyPromptKeywords": ["release", "deploy", "ship it", "publish", "배포", "릴리스", "릴리즈"] },
|
|
11
|
+
{ "taskType": "planning", "anyTags": ["planning", "plan"], "anyGroup": ["planning", "plan"], "anyNameKeywords": ["plan", "planning", "roadmap", "spec", "prd"], "anyPromptKeywords": ["plan", "roadmap", "spec", "계획", "기획", "설계"] },
|
|
12
|
+
{ "taskType": "data-analysis", "anyTags": ["data", "analysis", "analytics"], "anyGroup": ["data", "data-analysis"], "anyNameKeywords": ["data", "analysis", "analytics", "csv", "pandas", "chart", "metrics"], "anyPromptKeywords": ["analyze", "analysis", "csv", "chart", "metrics", "분석", "데이터", "통계"] },
|
|
13
|
+
{ "taskType": "browser-automation", "anyTags": ["browser", "automation", "scraping"], "anyGroup": ["browser", "browser-automation"], "anyNameKeywords": ["browser", "playwright", "puppeteer", "scrape", "scraping", "web"], "anyPromptKeywords": ["browser", "screenshot", "click", "scrape", "브라우저", "스크린샷", "크롤링"] },
|
|
14
|
+
{ "taskType": "git", "anyTags": ["git", "vcs"], "anyGroup": ["git"], "anyNameKeywords": ["git", "commit", "rebase", "merge", "branch"], "anyPromptKeywords": ["git", "commit", "rebase", "branch", "커밋", "브랜치", "리베이스"] }
|
|
15
|
+
]
|