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
package/dist/version.js
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
export class SkillarStartupError extends Error {
|
|
2
|
+
code;
|
|
3
|
+
constructor(code, message) {
|
|
4
|
+
super(message ? `${code}: ${message}` : code);
|
|
5
|
+
this.name = "SkillarStartupError";
|
|
6
|
+
this.code = code;
|
|
7
|
+
}
|
|
8
|
+
}
|
|
9
|
+
export const MIN_NODE = [24, 15];
|
|
10
|
+
export function assertNodeVersion(version = process.versions.node) {
|
|
11
|
+
const [major = 0, minor = 0] = version.split(".").map((part) => Number.parseInt(part, 10));
|
|
12
|
+
if (major < MIN_NODE[0] || (major === MIN_NODE[0] && minor < MIN_NODE[1])) {
|
|
13
|
+
throw new SkillarStartupError("node_too_old", `skillar needs Node >= ${MIN_NODE.join(".")}, found ${version}`);
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
export function assertPlatform(platform = process.platform) {
|
|
17
|
+
if (platform === "win32")
|
|
18
|
+
throw new SkillarStartupError("unsupported_platform", "skillar supports macOS and Linux");
|
|
19
|
+
}
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
const sorted = (values) => [...new Set(values)].sort();
|
|
2
|
+
/**
|
|
3
|
+
* Status per step:
|
|
4
|
+
* - `not_run` no pane was mapped to the step
|
|
5
|
+
* - `no_skill_used` the step's panes used no skill at all although the step intends some
|
|
6
|
+
* - `different` skills were used but none of them was intended (or the step intends none)
|
|
7
|
+
* - `partial` a `together` step used some but not all of its intended skills
|
|
8
|
+
* - `matched` the intent is satisfied: all intended skills for `together`, any one of them otherwise
|
|
9
|
+
*
|
|
10
|
+
* `extraSkills` (used but not intended) are reported, not penalised - deviations are feedback data, never enforcement.
|
|
11
|
+
* `unexpectedTools` stays empty while a step declares no `expectTools`, because nothing was expected to deviate from.
|
|
12
|
+
*/
|
|
13
|
+
export function compare(input) {
|
|
14
|
+
const panesByStep = new Map();
|
|
15
|
+
const mapped = new Set();
|
|
16
|
+
for (const { stepId, paneId } of input.steps) {
|
|
17
|
+
panesByStep.set(stepId, [...(panesByStep.get(stepId) ?? []), paneId]);
|
|
18
|
+
mapped.add(paneId);
|
|
19
|
+
}
|
|
20
|
+
const skillsOf = (panes) => panes.flatMap((p) => input.paneSkillUse[p] ?? []);
|
|
21
|
+
const steps = input.spec.steps.map((step) => {
|
|
22
|
+
const panes = sorted(panesByStep.get(step.id) ?? []);
|
|
23
|
+
const intended = sorted(step.skills);
|
|
24
|
+
const used = sorted(skillsOf(panes));
|
|
25
|
+
const intendedSet = new Set(intended);
|
|
26
|
+
const usedSet = new Set(used);
|
|
27
|
+
const hit = intended.filter((s) => usedSet.has(s));
|
|
28
|
+
const missingSkills = intended.filter((s) => !usedSet.has(s));
|
|
29
|
+
const extraSkills = used.filter((s) => !intendedSet.has(s));
|
|
30
|
+
const expected = new Set(step.expectTools);
|
|
31
|
+
const unexpectedTools = expected.size === 0 ? [] : sorted(panes.flatMap((p) => input.paneTools[p] ?? [])).filter((t) => !expected.has(t));
|
|
32
|
+
const status = panes.length === 0 ? "not_run"
|
|
33
|
+
: used.length === 0 ? (intended.length === 0 ? "matched" : "no_skill_used")
|
|
34
|
+
: hit.length === 0 ? "different"
|
|
35
|
+
: step.together && missingSkills.length > 0 ? "partial"
|
|
36
|
+
: "matched";
|
|
37
|
+
return { stepId: step.id, panes, intendedSkills: intended, usedSkills: used, status, extraSkills, missingSkills, unexpectedTools };
|
|
38
|
+
});
|
|
39
|
+
const unplanned = sorted(input.panes ?? Object.keys(input.paneSkillUse))
|
|
40
|
+
.filter((paneId) => !mapped.has(paneId))
|
|
41
|
+
.map((paneId) => ({ paneId, usedSkills: sorted(input.paneSkillUse[paneId] ?? []) }));
|
|
42
|
+
return { steps, unplanned };
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Store-backed input for compare(). Used skills come from the skillar `load` and `native_skill` events of the
|
|
46
|
+
* sessions linked to each pane; skill spans (todo 6) replace this source without changing the comparison.
|
|
47
|
+
* Returns undefined when the flow is unknown or was registered without a spec.
|
|
48
|
+
* `excludeSessions` leaves named sessions out, so a caller that hides automated sessions compares without them too.
|
|
49
|
+
*/
|
|
50
|
+
export function compareFlow(store, flowId, opts = {}) {
|
|
51
|
+
const flow = store.getFlow(flowId);
|
|
52
|
+
if (!flow?.spec)
|
|
53
|
+
return undefined;
|
|
54
|
+
const usage = store.flowPaneUsage(flowId, opts);
|
|
55
|
+
const paneSkillUse = {};
|
|
56
|
+
const paneTools = {};
|
|
57
|
+
for (const row of usage) {
|
|
58
|
+
paneSkillUse[row.paneId] = row.skills;
|
|
59
|
+
paneTools[row.paneId] = row.tools;
|
|
60
|
+
}
|
|
61
|
+
return compare({
|
|
62
|
+
spec: flow.spec.spec,
|
|
63
|
+
steps: store.flowSteps(flowId).map((s) => ({ stepId: s.stepId, paneId: s.paneId })),
|
|
64
|
+
paneSkillUse,
|
|
65
|
+
paneTools,
|
|
66
|
+
panes: usage.map((r) => r.paneId),
|
|
67
|
+
});
|
|
68
|
+
}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { deny } from "../api/security.js";
|
|
3
|
+
import { workflowSpecSchema } from "./spec.js";
|
|
4
|
+
const flowBodySchema = z.strictObject({
|
|
5
|
+
workspaceId: z.string().min(1).max(128),
|
|
6
|
+
tabId: z.string().min(1).max(128).optional(),
|
|
7
|
+
spec: z.strictObject({ name: z.string().min(1).max(64), version: z.number().int().positive().max(1_000_000).optional() }),
|
|
8
|
+
label: z.string().max(200).optional(),
|
|
9
|
+
});
|
|
10
|
+
const stepBodySchema = z.strictObject({
|
|
11
|
+
paneId: z.string().min(1).max(128),
|
|
12
|
+
stepId: z.string().min(1).max(64),
|
|
13
|
+
});
|
|
14
|
+
function handle(log, fn) {
|
|
15
|
+
return (req, res) => {
|
|
16
|
+
try {
|
|
17
|
+
fn(req, res);
|
|
18
|
+
}
|
|
19
|
+
catch (error) {
|
|
20
|
+
log(`${req.method} ${req.path} failed: ${error.stack ?? String(error)}`);
|
|
21
|
+
deny(res, 500, "internal_error");
|
|
22
|
+
}
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
/** Replies 400 with the failing paths and returns undefined, so each route can `if (!body) return;`. */
|
|
26
|
+
function parseBody(res, schema, body) {
|
|
27
|
+
const parsed = schema.safeParse(body);
|
|
28
|
+
if (parsed.success)
|
|
29
|
+
return parsed.data;
|
|
30
|
+
deny(res, 400, "bad_request", {
|
|
31
|
+
message: "request body does not match the schema",
|
|
32
|
+
issues: parsed.error.issues.slice(0, 10).map((i) => ({ path: i.path.join("."), message: i.message })),
|
|
33
|
+
});
|
|
34
|
+
return undefined;
|
|
35
|
+
}
|
|
36
|
+
function specView(row) {
|
|
37
|
+
return { id: row.id, name: row.name, version: row.version, digest: row.digest, createdMs: row.createdMs, steps: row.spec.steps };
|
|
38
|
+
}
|
|
39
|
+
export function registerWorkflowRoutes(app, deps) {
|
|
40
|
+
const { store, log } = deps;
|
|
41
|
+
app.post("/api/workflows", handle(log, (req, res) => {
|
|
42
|
+
const spec = parseBody(res, workflowSpecSchema, req.body);
|
|
43
|
+
if (!spec)
|
|
44
|
+
return;
|
|
45
|
+
const { row, created } = store.putWorkflowSpec(spec);
|
|
46
|
+
res.status(created ? 201 : 200).json({ id: row.id, name: row.name, version: row.version, digest: row.digest, createdMs: row.createdMs, created });
|
|
47
|
+
}));
|
|
48
|
+
app.get("/api/workflows", handle(log, (_req, res) => {
|
|
49
|
+
res.json(store.workflowSpecs().map(specView));
|
|
50
|
+
}));
|
|
51
|
+
app.get("/api/workflows/:name/versions", handle(log, (req, res) => {
|
|
52
|
+
const name = String(req.params.name);
|
|
53
|
+
const versions = store.workflowSpecVersions(name);
|
|
54
|
+
if (versions.length === 0)
|
|
55
|
+
return deny(res, 404, "spec_not_found", { message: `no workflow spec named ${name}` });
|
|
56
|
+
res.json(versions.map(specView));
|
|
57
|
+
}));
|
|
58
|
+
app.post("/api/flows", handle(log, (req, res) => {
|
|
59
|
+
const body = parseBody(res, flowBodySchema, req.body);
|
|
60
|
+
if (!body)
|
|
61
|
+
return;
|
|
62
|
+
const spec = store.workflowSpec(body.spec.name, body.spec.version);
|
|
63
|
+
if (!spec) {
|
|
64
|
+
return deny(res, 404, "spec_not_found", { message: `no workflow spec ${body.spec.name}${body.spec.version !== undefined ? ` version ${body.spec.version}` : ""}` });
|
|
65
|
+
}
|
|
66
|
+
const result = store.createFlow({
|
|
67
|
+
workspaceId: body.workspaceId, specId: spec.id,
|
|
68
|
+
...(body.tabId !== undefined ? { tabId: body.tabId } : {}),
|
|
69
|
+
...(body.label !== undefined ? { label: body.label } : {}),
|
|
70
|
+
});
|
|
71
|
+
if (!result.created) {
|
|
72
|
+
return deny(res, 409, "flow_already_open", { flowId: result.conflict.id, message: `flow ${result.conflict.id} is still open for this workspace and tab` });
|
|
73
|
+
}
|
|
74
|
+
const flow = result.flow;
|
|
75
|
+
res.status(201).json({
|
|
76
|
+
id: flow.id, workspaceId: flow.workspaceId, tabId: flow.tabId ?? null, label: flow.label ?? null,
|
|
77
|
+
spec: { id: spec.id, name: spec.name, version: spec.version }, registeredMs: flow.registeredMs,
|
|
78
|
+
});
|
|
79
|
+
}));
|
|
80
|
+
app.post("/api/flows/:id/steps", handle(log, (req, res) => {
|
|
81
|
+
const flow = store.getFlow(String(req.params.id));
|
|
82
|
+
if (!flow)
|
|
83
|
+
return deny(res, 404, "flow_not_found");
|
|
84
|
+
const body = parseBody(res, stepBodySchema, req.body);
|
|
85
|
+
if (!body)
|
|
86
|
+
return;
|
|
87
|
+
const steps = flow.spec?.spec.steps.map((s) => s.id) ?? [];
|
|
88
|
+
if (!steps.includes(body.stepId))
|
|
89
|
+
return deny(res, 400, "unknown_step", { message: `step ${body.stepId} is not in the flow's spec`, steps });
|
|
90
|
+
const { created } = store.mapFlowStep(flow.id, body.paneId, body.stepId);
|
|
91
|
+
res.status(created ? 201 : 200).json({ flowId: flow.id, paneId: body.paneId, stepId: body.stepId, created });
|
|
92
|
+
}));
|
|
93
|
+
app.post("/api/flows/:id/end", handle(log, (req, res) => {
|
|
94
|
+
const id = String(req.params.id);
|
|
95
|
+
const ended = store.endFlow(id);
|
|
96
|
+
if (!ended)
|
|
97
|
+
return deny(res, 404, "flow_not_found");
|
|
98
|
+
res.json({ id, endedMs: ended.endedMs, alreadyEnded: ended.alreadyEnded });
|
|
99
|
+
}));
|
|
100
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
/** Workflow and step ids are slugs: a letter or digit, then letters, digits, ".", "_" or "-". */
|
|
4
|
+
const SLUG = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
|
|
5
|
+
const slug = (max) => z.string().min(1).max(max).regex(SLUG, "must start with a letter or digit and use only letters, digits, '.', '_' or '-'");
|
|
6
|
+
export const MAX_STEPS = 50;
|
|
7
|
+
export const MAX_SKILLS_PER_STEP = 10;
|
|
8
|
+
export const MAX_NAME_LENGTH = 128;
|
|
9
|
+
export const workflowStepSchema = z.strictObject({
|
|
10
|
+
id: slug(64),
|
|
11
|
+
skills: z.array(z.string().min(1).max(MAX_NAME_LENGTH)).max(MAX_SKILLS_PER_STEP),
|
|
12
|
+
/** true: every intended skill is expected in the same step; false: any one of them satisfies it. */
|
|
13
|
+
together: z.boolean().default(false),
|
|
14
|
+
// The plan sets no element count for expectTools; the request body limit is the bound.
|
|
15
|
+
expectTools: z.array(z.string().min(1).max(MAX_NAME_LENGTH)).default([]),
|
|
16
|
+
doneWhen: z.string().max(500).optional(),
|
|
17
|
+
});
|
|
18
|
+
export const workflowSpecSchema = z.strictObject({
|
|
19
|
+
name: slug(64),
|
|
20
|
+
steps: z.array(workflowStepSchema).min(1).max(MAX_STEPS),
|
|
21
|
+
}).refine((spec) => new Set(spec.steps.map((s) => s.id)).size === spec.steps.length, {
|
|
22
|
+
message: "step ids must be unique",
|
|
23
|
+
path: ["steps"],
|
|
24
|
+
});
|
|
25
|
+
/** Object keys sorted recursively so key order in the request body never changes the digest. */
|
|
26
|
+
function canonical(value) {
|
|
27
|
+
if (Array.isArray(value))
|
|
28
|
+
return value.map(canonical);
|
|
29
|
+
if (value !== null && typeof value === "object") {
|
|
30
|
+
return Object.fromEntries(Object.entries(value)
|
|
31
|
+
.filter(([, v]) => v !== undefined)
|
|
32
|
+
.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
|
|
33
|
+
.map(([k, v]) => [k, canonical(v)]));
|
|
34
|
+
}
|
|
35
|
+
return value;
|
|
36
|
+
}
|
|
37
|
+
/** Digest of the parsed spec (defaults applied), so a body that only differs in key order or omitted defaults is the same version. */
|
|
38
|
+
export function specDigest(spec) {
|
|
39
|
+
return `sha256:${createHash("sha256").update(JSON.stringify(canonical(spec))).digest("hex")}`;
|
|
40
|
+
}
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# Execution ownership and session lifetime
|
|
2
|
+
|
|
3
|
+
## Recorded cuts (schema 6)
|
|
4
|
+
|
|
5
|
+
An execution is an analysis interval, not a session lifetime. Event timestamps remain
|
|
6
|
+
runtime timestamps. Equal timestamps do not establish causal order.
|
|
7
|
+
|
|
8
|
+
Registration and end capture a persistent database clock's domain and counter in the same
|
|
9
|
+
SQL statement as the lifecycle timestamp. Insert triggers advance that clock and stamp each
|
|
10
|
+
event/span atomically. Duplicate event/source-key and composite-span replays are no-ops.
|
|
11
|
+
An idempotent end never recaptures. Membership is resolved separately on read: mapping a
|
|
12
|
+
pane after registration or discovering its session after closure cannot move these cuts.
|
|
13
|
+
|
|
14
|
+
An event is owned when:
|
|
15
|
+
|
|
16
|
+
1. Its timestamp is at or after registration and at or before the end, when ended.
|
|
17
|
+
2. If equal to registration, its recorded order in the start domain exceeds the start cut.
|
|
18
|
+
3. If equal to the end, its recorded order in the end domain is at or below the end cut.
|
|
19
|
+
|
|
20
|
+
This is **local recording-order evidence at a timestamp tie**, not an assertion about
|
|
21
|
+
runtime causal order or network delivery order. Delayed boundary telemetry is not silently
|
|
22
|
+
reassigned to a completed execution. It remains in workspace/session history. Data recorded while
|
|
23
|
+
no execution was active may belong to neither execution, even if the clock did not advance.
|
|
24
|
+
Timestamp-interior events remain timestamp-scoped, including delayed telemetry received after
|
|
25
|
+
closure. This preserves the existing late-ingestion and attribution-reconciliation contract.
|
|
26
|
+
|
|
27
|
+
For adjacent A and B sharing millisecond t, an event recorded before A ends is at or below
|
|
28
|
+
A's end cut and B's start cut. An event recorded after B starts exceeds both cuts.
|
|
29
|
+
Thus neither category is duplicated or lost.
|
|
30
|
+
This also holds for zero-duration executions. No UUID comparison or SQLite rowid is used
|
|
31
|
+
to invent lifecycle order. The counter survives deletion, retention, reopening and VACUUM.
|
|
32
|
+
|
|
33
|
+
The owned event set is shared by tree membership, finding, usage, comparison and unresolved
|
|
34
|
+
load warnings. Earlier prompts only supply continuing turn identity, not inherited skills
|
|
35
|
+
or calls. Indexed conversation/call/exact-pair joins select relevant endpoint or untimed
|
|
36
|
+
spans, whose recorded order must pass the end cut. Interior delayed spans remain eligible.
|
|
37
|
+
`putSpans` keeps the first observation on replay. Explicit SQL corrections to span facts
|
|
38
|
+
receive new order and invalidate old provenance; changed endpoint facts cannot borrow the
|
|
39
|
+
former facts' pre-close order. The metadata contains no captured prompt/tool content.
|
|
40
|
+
|
|
41
|
+
Completed reports remain stable against the adjacent execution's boundary and later activity.
|
|
42
|
+
This is not an immutable export: delayed interior events, corrected attribution/reconciliation,
|
|
43
|
+
topology labels, automation classification and retained content can still change their
|
|
44
|
+
respective interpretation. The underlying event history is never deleted by flow scoping.
|
|
45
|
+
|
|
46
|
+
## Portable history and unavailable order
|
|
47
|
+
|
|
48
|
+
Each row stores order by recording domain. History import retains source-domain marks and
|
|
49
|
+
adds destination arrival order; chained export/import preserves both. The local clock is
|
|
50
|
+
never imported or reset. New local flows therefore see imported rows as already present,
|
|
51
|
+
while imported flows can still use their source cuts. Import skips existing identities:
|
|
52
|
+
if a duplicate lacks the source order, it remains unknown rather than borrowing local order.
|
|
53
|
+
Start and end domains can differ when an imported open flow is closed locally.
|
|
54
|
+
|
|
55
|
+
Migration establishes a new domain and marks existing observations at zero. This proves
|
|
56
|
+
only that they precede future cuts, not their relative order or a historical cut. Pre-v6
|
|
57
|
+
flow cuts remain unavailable because schema-5 identity snapshots may have omitted eventual
|
|
58
|
+
members. Known positive end identities remain usable; absence from an old start snapshot
|
|
59
|
+
is not proof of later arrival. Unproven exact-boundary events are excluded from credited
|
|
60
|
+
results and `executionScope.boundary` is `order_unavailable`. Interior timestamps remain usable.
|
|
61
|
+
The API and dashboard disclose this uncertainty and point to workspace history. A historical
|
|
62
|
+
same-millisecond causal ordering cannot be recovered from independent event and flow rowids.
|
|
63
|
+
An observation from a different database with no mark for a flow's domain is also uncertain
|
|
64
|
+
at equality. A full database restore retains its lineage; independently writable databases
|
|
65
|
+
must be created separately and combined through export/import, not forked database files.
|
|
66
|
+
|
|
67
|
+
## Lifecycle versus analysis
|
|
68
|
+
|
|
69
|
+
`SessionTree.startedAt` and `endedAt` describe observed session lifetime, never clipping.
|
|
70
|
+
In a completed execution, an end strictly inside the window can arrive late; an end exactly
|
|
71
|
+
at the boundary must have been observed at closure. An end beyond the window is not part
|
|
72
|
+
of that execution's observations and is NULL there. The unscoped session report retains the
|
|
73
|
+
latest actual termination observation.
|
|
74
|
+
Bounded member-session end snapshots preserve already known ends against later updates.
|
|
75
|
+
An end-order stamp also recognizes a current endpoint termination when membership is learned
|
|
76
|
+
after close. Neither a later termination nor flow closure invents a previous observed end.
|
|
77
|
+
`executionWindow: { from, to }` separately describes the analysis slice. Turn/span durations
|
|
78
|
+
are clipped to this slice. An execution end never becomes a session end.
|
|
79
|
+
|
|
80
|
+
An unended session in an ended flow renders `end_not_observed`, not `ended`. A complete
|
|
81
|
+
herdr snapshot omitting both agent fields after a known agent was present is an observed
|
|
82
|
+
disappearance; an omitted field in a partial status event is not.
|
|
83
|
+
|
|
84
|
+
## Attribution uncertainty
|
|
85
|
+
|
|
86
|
+
Unresolved load disclosures show the real count and every affected URI in both flow and
|
|
87
|
+
session trace reports. They mean a recorded load cannot yet be assigned confidently, not
|
|
88
|
+
that a skill was unused. Flow warnings use the same recorded-order predicates as the tree;
|
|
89
|
+
reconciliation remains responsible for candidate and URI matching.
|
|
90
|
+
|
|
91
|
+
## Storage cost
|
|
92
|
+
|
|
93
|
+
Registration stores only a scalar cut. End stores a scalar cut and bounded member-session
|
|
94
|
+
end observations, not event IDs or historical span IDs. Candidate-session event and load
|
|
95
|
+
indexes bound reads; endpoint span joins use the same indexes as tree assembly. GET is
|
|
96
|
+
read-only. Unrelated history does not enlarge cut identities or scope-query populations.
|
|
97
|
+
Native observation metadata has one domain entry; imported metadata grows with its database
|
|
98
|
+
ancestry, not with unrelated history. A search benchmark is separate from flow-scale checks.
|
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
# MCP 2026-07-28 and Skills conformance
|
|
2
|
+
|
|
3
|
+
Audit date: October 14, 2026. Paths below are relative to `local/`.
|
|
4
|
+
Implementation revision: `3318fb1` - Serve skillar over modern MCP with standard skill resources.
|
|
5
|
+
|
|
6
|
+
Understood scope: replace the initialization-based MCP implementation, serve skill bytes only through
|
|
7
|
+
standard resources, retain search and dashboard observations, and leave installed agents and the running
|
|
8
|
+
user daemon untouched. This is a server implementation and a transparent stdio transport bridge, not a
|
|
9
|
+
skill-activating host.
|
|
10
|
+
|
|
11
|
+
## Specification and SDK decision
|
|
12
|
+
|
|
13
|
+
The normative Skills source is `specification/stable/skills.mdx` at
|
|
14
|
+
`modelcontextprotocol/ext-skills@167da6c0d42c247a8f8470228a10ca711e3f6c45`.
|
|
15
|
+
Its `docs/decisions.md` was read in full. The stable page takes precedence over superseded decisions
|
|
16
|
+
(notably: `resources: "dynamic"` rather than omitted resources; no archives or index resource;
|
|
17
|
+
required cache attributes on both Skills results).
|
|
18
|
+
|
|
19
|
+
Sources:
|
|
20
|
+
|
|
21
|
+
- https://raw.githubusercontent.com/modelcontextprotocol/ext-skills/167da6c0d42c247a8f8470228a10ca711e3f6c45/specification/stable/skills.mdx
|
|
22
|
+
- https://raw.githubusercontent.com/modelcontextprotocol/ext-skills/167da6c0d42c247a8f8470228a10ca711e3f6c45/docs/decisions.md
|
|
23
|
+
- https://modelcontextprotocol.io/specification/2026-07-28/basic
|
|
24
|
+
- https://modelcontextprotocol.io/specification/2026-07-28/basic/versioning
|
|
25
|
+
- https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http
|
|
26
|
+
- https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/stdio
|
|
27
|
+
- https://modelcontextprotocol.io/specification/2026-07-28/server/discover
|
|
28
|
+
- https://modelcontextprotocol.io/specification/2026-07-28/server/resources
|
|
29
|
+
- https://modelcontextprotocol.io/specification/2026-07-28/server/tools
|
|
30
|
+
- https://modelcontextprotocol.io/specification/2026-07-28/server/utilities/pagination
|
|
31
|
+
- https://modelcontextprotocol.io/specification/2026-07-28/server/utilities/caching
|
|
32
|
+
- https://agentskills.io/specification
|
|
33
|
+
|
|
34
|
+
`npm view @modelcontextprotocol/sdk versions --json` reported 1.32.1 as newest. The published
|
|
35
|
+
1.32.1 `dist/esm/types.js` still defines `LATEST_PROTOCOL_VERSION = '2025-11-25'`; its published
|
|
36
|
+
client and server implementations have no `server/discover`, and its package inventory has no
|
|
37
|
+
modern-era implementation. The newer SDK repository's split-package documentation is not evidence
|
|
38
|
+
that this npm package supports the revision. The legacy dependency and its 25 exclusive dependencies
|
|
39
|
+
were removed. The seven requested RPCs are implemented directly over Express and stdio.
|
|
40
|
+
|
|
41
|
+
SDK evidence: `https://unpkg.com/@modelcontextprotocol/sdk@1.32.1/dist/esm/types.js`,
|
|
42
|
+
`https://unpkg.com/@modelcontextprotocol/sdk@1.32.1/dist/esm/client/index.js`,
|
|
43
|
+
`https://unpkg.com/@modelcontextprotocol/sdk@1.32.1/dist/esm/server/index.js`.
|
|
44
|
+
|
|
45
|
+
## Server-side Skills MUST/SHOULD checklist
|
|
46
|
+
|
|
47
|
+
Each row covers the stated server obligation, including repeated obligations in the stable page.
|
|
48
|
+
Host-only obligations are separated below rather than claimed as implemented by the server.
|
|
49
|
+
|
|
50
|
+
| Normative obligation | Status and implementation |
|
|
51
|
+
| --- | --- |
|
|
52
|
+
| Every request MUST carry required base `_meta`. | PASS: `src/mcp/protocol.ts:35`, `src/mcp/protocol.ts:52`, `src/mcp/http.ts:33`, `src/mcp/stdio-proxy.ts:35`. |
|
|
53
|
+
| Declaring Skills MUST implement `skills/list` and `skills/get`. | PASS: `src/mcp/dispatch.ts:22`, `src/mcp/dispatch.ts:38`, `src/mcp/dispatch.ts:41`. |
|
|
54
|
+
| Declaring Skills MUST also declare Resources. | PASS: `src/mcp/dispatch.ts:22`. |
|
|
55
|
+
| A server declaring `directoryRead: true` MUST implement directory reading for every directory. | NOT APPLICABLE: the setting is omitted, meaning false; `src/mcp/dispatch.ts:22`. Unknown directory methods receive `-32601`. |
|
|
56
|
+
| Served skills MUST conform to Agent Skills format. | PASS: required fields and optional-field types/lengths in `src/catalog/fields.ts:74`; root file and matching directory in `src/catalog/scanner.ts:84`. Unknown author fields remain intact. |
|
|
57
|
+
| Every skill MUST contain root `SKILL.md`, beginning with YAML frontmatter with name/description. | PASS: `src/catalog/scanner.ts:84`, `src/catalog/fields.ts:8`, `src/catalog/fields.ts:74`. Invalid/non-JSON frontmatter is not published. |
|
|
58
|
+
| Servers SHOULD use `skill://`; final path segment MUST equal the name and satisfy its naming rules. | PASS: `src/catalog/uri.ts:7`, `src/catalog/fields.ts:76`, `src/catalog/scanner.ts:137`. Unicode lowercase alphanumerics and single hyphens are accepted; names are 1-64 characters. URI segments are percent-encoded. |
|
|
59
|
+
| Authority SHOULD be a valid reg-name; prefixes SHOULD be valid URI segments. | PASS: fixed `local` authority, encoded path segments: `src/catalog/uri.ts:4`, `src/catalog/uri.ts:7`. |
|
|
60
|
+
| Every file is exposed as a resource; supporting files remain inside the skill's directory. | PASS: complete traversal in `src/catalog/scanner.ts:33`, mapping in `src/catalog/scanner.ts:120`, canonical URI/path checks in `src/catalog/uri.ts:13`, `src/catalog/scanner.ts:180`. Unaddressable organizational prefixes reject the whole skill at `src/catalog/scanner.ts:85`. |
|
|
61
|
+
| SKILL.md resource MIME SHOULD be Markdown, name/description SHOULD come from frontmatter. | PASS: `src/mcp/skills-extension.ts:12`, `src/mcp/skills-extension.ts:40`. |
|
|
62
|
+
| Additional resource `_meta` SHOULD use the reserved Skills prefix; intermediary annotations MUST use their own prefix. | NOT APPLICABLE: no additional resource `_meta` or provenance annotations are emitted. Server identity uses the base protocol's own key. |
|
|
63
|
+
| Nested files are supporting content in the enclosing manifest; nested publication is flat. | PASS: `src/catalog/scanner.ts:33`, `src/catalog/scanner.ts:61`, `src/mcp/skills-extension.ts:29`. Both entries include the same nested bytes. Reading either is only an observation. |
|
|
64
|
+
| Frontmatter MUST be identical in content to SKILL.md, not a selected subset. | PASS: YAML parsing in `src/catalog/fields.ts:8`, JSON representability check in `src/catalog/scanner.ts:125`, unchanged wire mapping in `src/mcp/skills-extension.ts:24`. |
|
|
65
|
+
| Unknown `metadata` keys under `io.modelcontextprotocol/` SHOULD be ignored. | PASS: metadata is validated/preserved but never interpreted: `src/catalog/fields.ts:79`. No permissions are derived from it. |
|
|
66
|
+
| Names SHOULD be unique within a listing, but are not guaranteed unique. | DELIBERATE SHOULD EXCEPTION: configured roots may contain same-named skills. Renaming breaks the name/directory rule; silently dropping one loses a configured skill. Preserve distinct URIs and let hosts disambiguate. `src/catalog/index.ts:119` reports cross-root duplicates. |
|
|
67
|
+
| Every entry MUST carry `resources`, complete and exactly once per file, including its SKILL.md. | PASS: `src/catalog/scanner.ts:33`, `src/catalog/scanner.ts:116`, `src/mcp/skills-extension.ts:24`. No dotfile or dependency-directory exclusions. A skill with symlinks, non-regular entries or unaddressable paths is rejected as a whole, never truncated. |
|
|
68
|
+
| Every manifest URI MUST identify SKILL.md or a file within its skill directory. | PASS: `src/catalog/scanner.ts:120`, `src/catalog/uri.ts:7`; directory traversal and aliases are rejected by `src/catalog/uri.ts:13`. |
|
|
69
|
+
| Every resource MUST carry raw-byte size and a lowercase SHA-256 digest. | PASS: `src/catalog/scanner.ts:23`, `src/catalog/scanner.ts:117`. Nested files count in both manifests. |
|
|
70
|
+
| Dynamic content MUST use `"dynamic"` rather than omit resources. | NOT APPLICABLE: only static filesystem skills with publishable digests are served; all entries use complete arrays. |
|
|
71
|
+
| Servers SHOULD NOT serve skills over 512 resources or 16 MiB. | PASS, inclusive boundaries: `src/catalog/scanner.ts:11`, `src/catalog/scanner.ts:48`, `src/catalog/scanner.ts:128`. Entire oversize skills are rejected. |
|
|
72
|
+
| `skills/list` MUST exist and return `resultType: "complete"`. | PASS: `src/mcp/dispatch.ts:38`, `src/mcp/dispatch.ts:53`. |
|
|
73
|
+
| List pagination follows cursor/nextCursor; entries/manifests remain atomic. | PASS: `src/mcp/pagination.ts:6`, `src/mcp/skills-extension.ts:29`. Cursors are stable, method-scoped, and stateless; invalid/stale cursors give `-32602`. |
|
|
74
|
+
| `skills/list` MUST carry CacheableResult fields. | PASS: `src/mcp/skills-extension.ts:31`, `src/mcp/protocol.ts:8`. Every page carries the same private scope. |
|
|
75
|
+
| `skills/get` MUST return a complete result and answer for every served skill by its SKILL.md URI, including skills absent from a page. | PASS: direct catalog lookup in `src/mcp/skills-extension.ts:34`, common result envelope in `src/mcp/dispatch.ts:53`. No pagination cursor is returned. |
|
|
76
|
+
| `skills/get` of a non-skill URI MUST return `-32602`. | PASS: `src/mcp/skills-extension.ts:36`; an existing supporting file is not treated as a skill. |
|
|
77
|
+
| `skills/get` MUST carry CacheableResult fields. | PASS: `src/mcp/skills-extension.ts:37`. |
|
|
78
|
+
| Skill content is read with standard `resources/read`, without skill-specific loading semantics. | PASS: `src/mcp/dispatch.ts:47`, `src/mcp/skills-extension.ts:54`. No tool-based loading path or prior-load requirement remains. |
|
|
79
|
+
| Unknown skill-file reads MUST return `-32602`; internal failures MUST return `-32603`. | PASS: `src/mcp/skills-extension.ts:61`, `src/mcp/protocol.ts:69`. Stale digest failures fail closed with `-32603` and a refresh hint. No legacy resource error is emitted. |
|
|
80
|
+
| Protocol errors MUST be standard JSON-RPC errors; messages SHOULD explain the cause. | PASS: `src/mcp/protocol.ts:65`, `src/mcp/skills-extension.ts:36`, `src/mcp/skills-extension.ts:64`. |
|
|
81
|
+
|
|
82
|
+
## Base protocol and delivery checks
|
|
83
|
+
|
|
84
|
+
| Requirement | Implementation / evidence |
|
|
85
|
+
| --- | --- |
|
|
86
|
+
| Modern-era requests accept only 2026-07-28; unsupported versions return `-32022` with requested/supported values. | `src/mcp/protocol.ts:3`, `src/mcp/protocol.ts:58`. `supportedVersions` lists modern revisions only; legacy revisions are reachable solely through `initialize`. |
|
|
87
|
+
| No initialize/session handshake for modern requests; discovery is optional before ordinary requests. | `src/mcp/dispatch.ts:19`; fresh direct calls are tested. |
|
|
88
|
+
| Dual-era: a request with modern `_meta` is served statelessly; `initialize` selects legacy semantics per HTTP session or stdio process (versioning, "Backward Compatibility with Initialization-Based Versions"). | `src/mcp/legacy.ts`, `src/mcp/http.ts`, `src/mcp/stdio-proxy.ts`. Legacy requests are translated to modern requests with synthesized `_meta`; legacy results drop modern-only envelope fields. A real `@modelcontextprotocol/sdk` 1.30.0 client negotiated 2025-11-25 over HTTP and stdio. |
|
|
89
|
+
| Per-request identity/capabilities; no connection carries prior client context. | `src/mcp/dispatch.ts:15`, `src/mcp/stdio-proxy.ts:35`. Vendor metadata survives forwarding. |
|
|
90
|
+
| String/integer non-null IDs, one message per POST, same response ID, JSON-RPC errors. | `src/mcp/protocol.ts:16`, `src/mcp/protocol.ts:26`, `src/mcp/http.ts:20`. |
|
|
91
|
+
| Every success has resultType and SHOULD identify serverInfo. | `src/mcp/dispatch.ts:53`. |
|
|
92
|
+
| HTTP version/method/name headers are mandatory and body-validated; malformed/mismatched headers give 400 / `-32020`. | `src/mcp/protocol.ts:94`; Base64 sentinel and UTF-8/BOM handling in `src/mcp/protocol.ts:76`. |
|
|
93
|
+
| Missing request metadata gives 400 / `-32602`; unknown methods give 404 / `-32601`. | `src/mcp/protocol.ts:52`, `src/mcp/http.ts:43`. |
|
|
94
|
+
| Origin validation, loopback binding, bearer authentication and body limits remain enforced. | `src/api/security.ts:38`, `src/server.ts:35`, `src/server.ts:138`, `src/mcp/http.ts:12`, `src/mcp/http.ts:19`; composed-server security tests cover MCP. |
|
|
95
|
+
| Accepted notifications get 202 with no body; GET/DELETE get 405; session/replay headers on modern requests do not create state. | `src/mcp/http.ts:26`, `src/mcp/http.ts:47`. |
|
|
96
|
+
| stdio uses newline-delimited JSON and preserves request metadata; no SDK initialization upstream. | `src/mcp/stdio-proxy.ts:5`, `src/mcp/protocol.ts:112`. |
|
|
97
|
+
| stdio cancellation aborts the request fetch and suppresses later replies; EOF/signals abort pending requests. | `src/mcp/stdio-proxy.ts:10`, `src/mcp/stdio-proxy.ts:26`, `src/mcp/stdio-proxy.ts:49`. Filesystem reads already in progress can finish; no messages are sent after cancellation. |
|
|
98
|
+
| Cacheable discovery, tool list, resource list/read, and both Skills results carry nonnegative TTL and scope. | `src/mcp/protocol.ts:8`, `src/mcp/dispatch.ts:19`, `src/mcp/skills-extension.ts:29`. Every list page stays private. |
|
|
99
|
+
| Only search is a tool; deterministic listing, validated inputs, rate limiting, JSON-safe results. | `src/mcp/tools.ts:29`, `src/mcp/tools.ts:38`, `src/mcp/tools.ts:46`, `src/mcp/dispatch.ts:26`. JSON Schema 2020-12 is emitted; no custom parameter-header annotations or remote `$ref`s are used. |
|
|
100
|
+
| Resource MIME and byte integrity; binary data encoded correctly; no empty success for missing resources. | `src/mcp/skills-extension.ts:78`, `src/catalog/index.ts:100`. |
|
|
101
|
+
| Required client capabilities cannot be assumed. | No sampling, elicitation, roots or other client-side feature is requested; no `-32021` condition is required by these handlers. |
|
|
102
|
+
| Dashboard loads/read_file events survive standard resource reads. | `src/mcp/skills-extension.ts:68`, `src/ingest/mcp-recorder.ts:38`; load events explicitly carry `observationOnly: true`. Trace, flow and heatmap assertions pass. |
|
|
103
|
+
| Configuration writers do not synthesize a protocol handshake. | Writers contain endpoint/transport/auth configuration only. `src/cli/init.ts:118` states the new requirement; `src/packs/codex.ts:146` explains the relevant Codex feature. No client-wide flags or real user configurations were edited. |
|
|
104
|
+
|
|
105
|
+
## Host responsibilities and optional features
|
|
106
|
+
|
|
107
|
+
The stable page's host MUST/SHOULD rules remain host responsibilities: server-scoped identity and caches,
|
|
108
|
+
origin labels, collisions across origins, URI rather than name identity, no DNS interpretation of authorities,
|
|
109
|
+
frontmatter/digest/size verification, held-manifest membership, lazy retrieval, relative reference resolution,
|
|
110
|
+
consent and nested-skill reapproval, permission gating, code-execution approval, and cache isolation.
|
|
111
|
+
skillar does not impersonate a host or claim a resource read activates a skill. Its `load` event is dashboard
|
|
112
|
+
terminology for an observed published SKILL.md read, not a host acting window. `allowed-tools` is never executed
|
|
113
|
+
or granted by skillar.
|
|
114
|
+
|
|
115
|
+
Directory reading, dynamic manifests, list-change subscriptions, MRTR, remote-reference schema validation,
|
|
116
|
+
and custom tool-parameter headers are not advertised or used. They are not missing declared capabilities.
|
|
117
|
+
The only intentional server SHOULD exception is duplicate skill labels described above; no known server MUST
|
|
118
|
+
gap remains in the supported surface.
|
|
119
|
+
|
|
120
|
+
## Client-facing breaking changes
|
|
121
|
+
|
|
122
|
+
- Legacy initialize clients (2024-11-05 through 2025-11-25) are served under dual-era rules, including
|
|
123
|
+
SDK 1.x-based clients (OmO/Senpi 1.29.0, Gemini CLI 1.23.0, OpenClaw 1.32.1), Codex without its
|
|
124
|
+
`mcp_2026_07_28` feature, and Claude Code legacy negotiation. GET streams and DELETE still return 405,
|
|
125
|
+
so the deprecated HTTP+SSE transport is unavailable; such clients must use stdio.
|
|
126
|
+
- Custom skill-loading tools and load handles are gone from the MCP surface. Clients must expose a
|
|
127
|
+
standard resource reader to the model and implement the host's Skills verification/approval path.
|
|
128
|
+
- Invalid skill names/frontmatter, oversized skills, and skills whose full manifests cannot be served
|
|
129
|
+
are no longer published. Hidden and dependency files now count toward limits and digests.
|
|
130
|
+
|
|
131
|
+
Compatibility evidence retrieved on the audit date, not claims of launching these installed agents:
|
|
132
|
+
|
|
133
|
+
- Locally inspected OmO/Senpi sibling checkout: `packages/coding-agent/package.json`, SDK 1.29.0.
|
|
134
|
+
- https://raw.githubusercontent.com/google-gemini/gemini-cli/main/packages/core/package.json
|
|
135
|
+
- https://raw.githubusercontent.com/google-gemini/gemini-cli/main/packages/core/src/tools/mcp-client.ts
|
|
136
|
+
- https://raw.githubusercontent.com/openclaw/openclaw/main/package.json
|
|
137
|
+
- https://raw.githubusercontent.com/openai/codex/main/codex-rs/rmcp-client/src/protocol_mode.rs
|
|
138
|
+
- https://raw.githubusercontent.com/openai/codex/main/codex-rs/app-server/README.md
|
|
139
|
+
- https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md
|
|
140
|
+
|
|
141
|
+
## Verification
|
|
142
|
+
|
|
143
|
+
- `npm run build`, `npm run typecheck`, `npm test`: exit 0; 270 tests pass.
|
|
144
|
+
- `node bench/search.mjs --check`: exit 0; all eight benchmark gates pass. Its own reported limitation
|
|
145
|
+
remains: these are maintainer-authored regression cases, not an independent search-quality holdout.
|
|
146
|
+
- `node bench/mcp-mutations.mjs`: exit 0; 49/49 mutants killed by assertions.
|
|
147
|
+
Each mutant is injected by a Node module hook only in memory.
|
|
148
|
+
An assertion failure is required; syntax errors, target misses and timeouts do not count.
|
|
149
|
+
Source and compiled files remain unchanged.
|
|
150
|
+
- `test/e2e/daemon.test.mjs` starts the real CLI daemon on an ephemeral non-8799 port, drives
|
|
151
|
+
discover -> sole tool -> search -> SKILL.md read -> supporting read, verifies the manifest digest,
|
|
152
|
+
queries load/read_file events and dashboard trace/flow/heatmap, accepts a legacy initialize, and tears down.
|
|
153
|
+
Sandbox HOME is created before deriving SKILLAR_HOME; SKILLAR_NO_CLI disables runtime registration.
|
|
154
|
+
- A separate isolated-HOME run passed all three daemon tests; `npm ci --ignore-scripts --dry-run`
|
|
155
|
+
also accepted the pruned lockfile without installing or changing dependencies.
|
|
156
|
+
- The user daemon on 8799, installed packages, and user configurations were not modified or restarted.
|