v0.7.1 Surface Runner Framework
All checks were successful
CI/CD / detect-changes (pull_request) Successful in 23s
CI/CD / test-frontend (pull_request) Successful in 26s
CI/CD / test-go-pg (pull_request) Successful in 2m35s
CI/CD / test-sqlite (pull_request) Successful in 3m19s
CI/CD / build-and-deploy (pull_request) Successful in 1m46s

sw.testing SDK module — structured test framework for surface runners:
- suite/test registration, lifecycle hooks (beforeAll/afterAll/beforeEach/afterEach)
- Assertion library (ok/eq/neq/gt/match/throws/status/shape/arrayOf)
- Auto-cleanup via track(type, id) with LIFO deletion
- Three result statuses: passed/failed/warned
- Structured JSON results with timing, warnings, cleanup stats

test-runner manifest type:
- ValidateManifest accepts "test-runner" packages
- Excluded from sidebar nav (extensionNavItems filters surface/full only)
- DB migrations: SQLite 013, Postgres 014 (CHECK constraint)

ICD runner migration (kernel-only):
- Migrated from T.test()/T.assert() to sw.testing.suite()
- Stripped extension-dependent tests (channels, notes, personas, etc.)
- Kernel suites: smoke, crud, authz, security, providers, packaging, sdk
- Deleted ui.js + css (rendering delegated to registry surface)

SDK runner migration (kernel-only):
- Migrated from T.dualTest()/T.domains to sw.testing.suite()
- Stripped extension domains (belong in v0.7.2 package runners)
- Kernel suites: misc, workflows, admin, packages, connections, deps, composition

Runner registry surface (/s/test-runners):
- Admin-only dashboard discovering test-runner packages
- Run All / per-runner Run buttons, real-time results
- Export Failures / Export Full Results (JSON download)
- Dark mode styling using kernel CSS variables
- Suite count polling for async runner script loading

141 passed, 0 failed on fresh minimal install.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-01 22:49:55 +00:00
parent e916ed41ea
commit f1c47002aa
59 changed files with 2509 additions and 6525 deletions

View File

@@ -1,191 +1,174 @@
/**
* SDK Test Runner — Domain: misc
*
* Covers smaller domains: notifications, folders, profile,
* data portability, health, models, users, presence, usage, groups,
* tools, git.
* Covers kernel domains: health, profile, notifications, users, groups,
* data portability.
* Extension-dependent domains (models, folders, presence, usage, tools)
* belong in package runners, not here.
*/
(function () {
'use strict';
var T = window.SDKR;
if (!T) return;
T.registerDomain('misc', async function () {
var tag = 'sdkr-' + Date.now();
sw.testing.suite('sdk/misc', async function (s) {
// ═══════════════════════════════════════════════════════════
// HEALTH
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'health', 'sw.api.health()', {
sdk: function () { return sw.api.health(); },
raw: { method: 'GET', path: '/health' },
validate: function (r) { T.assert(r.status === 'ok', 'status should be ok'); }
s.test('health: sw.api.health()', async function (t) {
var result = await T.dualTest(
function () { return sw.api.health(); },
{ method: 'GET', path: '/health' },
function (r) { T.assert(r.status === 'ok', 'status should be ok'); }
);
if (result.verdict === 'PASS') return;
if (result.verdict === 'SDK_BUG') t.assert.ok(false, 'SDK_BUG: ' + result.sdkErr);
if (result.verdict === 'ICD_BUG') t.assert.ok(false, 'ICD_BUG: ' + result.rawErr);
if (result.verdict === 'SHAPE_BUG') t.warn('SHAPE_BUG: ' + result.sdkErr);
});
// ═══════════════════════════════════════════════════════════
// PROFILE
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'profile', 'sw.api.profile.get()', {
sdk: function () { return sw.api.profile.get(); },
raw: { method: 'GET', path: '/profile' },
validate: function (r) { T.assertShape(r, T.S.profile, 'profile'); }
s.test('profile: sw.api.profile.get()', async function (t) {
var result = await T.dualTest(
function () { return sw.api.profile.get(); },
{ method: 'GET', path: '/profile' },
function (r) { T.assertShape(r, T.S.profile, 'profile'); }
);
if (result.verdict === 'PASS') return;
if (result.verdict === 'SDK_BUG') t.assert.ok(false, 'SDK_BUG: ' + result.sdkErr);
if (result.verdict === 'ICD_BUG') t.assert.ok(false, 'ICD_BUG: ' + result.rawErr);
if (result.verdict === 'SHAPE_BUG') t.warn('SHAPE_BUG: ' + result.sdkErr);
});
await T.test('misc', 'profile', 'sw.api.profile.permissions()', {
sdk: function () {
if (sw.api.profile.permissions) return sw.api.profile.permissions();
throw new Error('sw.api.profile.permissions not defined');
},
raw: { method: 'GET', path: '/profile/permissions' },
validate: function (r) {
T.assert(Array.isArray(r.permissions), 'permissions should be array');
}
s.test('profile: sw.api.profile.permissions()', async function (t) {
var result = await T.dualTest(
function () {
if (sw.api.profile.permissions) return sw.api.profile.permissions();
throw new Error('sw.api.profile.permissions not defined');
},
{ method: 'GET', path: '/profile/permissions' },
function (r) {
T.assert(Array.isArray(r.permissions), 'permissions should be array');
}
);
if (result.verdict === 'PASS') return;
if (result.verdict === 'SDK_BUG') t.assert.ok(false, 'SDK_BUG: ' + result.sdkErr);
if (result.verdict === 'ICD_BUG') t.assert.ok(false, 'ICD_BUG: ' + result.rawErr);
if (result.verdict === 'SHAPE_BUG') t.warn('SHAPE_BUG: ' + result.sdkErr);
});
// ═══════════════════════════════════════════════════════════
// MODELS
// NOTIFICATIONS
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'models', 'sw.api.models.enabled()', {
sdk: function () {
if (sw.api.models && sw.api.models.enabled) return sw.api.models.enabled();
throw new Error('sw.api.models.enabled not defined');
},
raw: { method: 'GET', path: '/models/enabled' },
validate: function (r) { var arr = T.unwrapList(r); T.assert(arr.length >= 0, 'expected list'); }
s.test('notifications: sw.api.notifications.list()', async function (t) {
var result = await T.dualTest(
function () { return sw.api.notifications.list(); },
{ method: 'GET', path: '/notifications' },
function (r) { var arr = T.unwrapList(r); T.assert(arr.length >= 0, 'expected list'); }
);
if (result.verdict === 'PASS') return;
if (result.verdict === 'SDK_BUG') t.assert.ok(false, 'SDK_BUG: ' + result.sdkErr);
if (result.verdict === 'ICD_BUG') t.assert.ok(false, 'ICD_BUG: ' + result.rawErr);
if (result.verdict === 'SHAPE_BUG') t.warn('SHAPE_BUG: ' + result.sdkErr);
});
// ═══════════════════════════════════════════════════════════
// FOLDERS
// ═══════════════════════════════════════════════════════════
var folderId = null;
await T.test('misc', 'folders', 'sw.api.folders.list()', {
sdk: function () { return sw.api.folders.list(); },
raw: { method: 'GET', path: '/folders' },
validate: function (r) { var arr = T.unwrapList(r); T.assert(arr.length >= 0, 'expected list'); }
s.test('notifications: sw.api.notifications.unreadCount()', async function (t) {
var result = await T.dualTest(
function () { return sw.api.notifications.unreadCount(); },
{ method: 'GET', path: '/notifications/unread-count' },
function (r) { T.assert(typeof r === 'object', 'expected object'); }
);
if (result.verdict === 'PASS') return;
if (result.verdict === 'SDK_BUG') t.assert.ok(false, 'SDK_BUG: ' + result.sdkErr);
if (result.verdict === 'ICD_BUG') t.assert.ok(false, 'ICD_BUG: ' + result.rawErr);
if (result.verdict === 'SHAPE_BUG') t.warn('SHAPE_BUG: ' + result.sdkErr);
});
await T.test('misc', 'folders', 'sw.api.folders.create()', {
sdk: function () {
return sw.api.folders.create(tag + '-folder');
},
raw: { method: 'POST', path: '/folders', body: { name: tag + '-folder', parent_id: null, sort_order: 0 } },
validate: function (r) {
// Backend returns { folder: {...} } — SDK passes envelope through
var obj = r.folder || r;
T.assertShape(obj, T.S.folder, 'folder');
folderId = obj.id;
T.registerCleanup(function () { if (folderId) return T.safeDelete('/folders/' + folderId); });
}
});
if (folderId) {
await T.test('misc', 'folders', 'sw.api.folders.update(id, data)', {
sdk: function () { return sw.api.folders.update(folderId, { name: tag + '-fold-upd' }); },
raw: { method: 'PUT', path: '/folders/' + folderId, body: { name: tag + '-fold-upd' } },
validate: function (r) { T.assert(r && (r.ok || r.id || r.folder), 'expected ok or folder'); }
});
await T.test('misc', 'folders', 'sw.api.folders.del(id)', {
sdk: function () { return sw.api.folders.del(folderId); },
raw: { method: 'DELETE', path: '/folders/' + folderId },
validate: function () { folderId = null; }
});
}
// ═══════════════════════════════════════════════════════════
// NOTIFICATIONS (duplicate key bug fixed — prefs/setPref/delPref restored)
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'notifications', 'sw.api.notifications.list()', {
sdk: function () { return sw.api.notifications.list(); },
raw: { method: 'GET', path: '/notifications' },
validate: function (r) { var arr = T.unwrapList(r); T.assert(arr.length >= 0, 'expected list'); }
});
await T.test('misc', 'notifications', 'sw.api.notifications.unreadCount()', {
sdk: function () { return sw.api.notifications.unreadCount(); },
raw: { method: 'GET', path: '/notifications/unread-count' },
validate: function (r) { T.assert(typeof r === 'object', 'expected object'); }
});
await T.test('misc', 'notifications', 'sw.api.notifications.prefs()', {
sdk: function () {
if (typeof sw.api.notifications.prefs === 'function') return sw.api.notifications.prefs();
throw new Error('sw.api.notifications.prefs is ' + typeof sw.api.notifications.prefs);
},
raw: { method: 'GET', path: '/notifications/preferences' },
validate: function () { /* existence is sufficient */ }
s.test('notifications: sw.api.notifications.prefs()', async function (t) {
var result = await T.dualTest(
function () {
if (typeof sw.api.notifications.prefs === 'function') return sw.api.notifications.prefs();
throw new Error('sw.api.notifications.prefs is ' + typeof sw.api.notifications.prefs);
},
{ method: 'GET', path: '/notifications/preferences' },
function () { /* existence is sufficient */ }
);
if (result.verdict === 'PASS') return;
if (result.verdict === 'SDK_BUG') t.assert.ok(false, 'SDK_BUG: ' + result.sdkErr);
if (result.verdict === 'ICD_BUG') t.assert.ok(false, 'ICD_BUG: ' + result.rawErr);
if (result.verdict === 'SHAPE_BUG') t.warn('SHAPE_BUG: ' + result.sdkErr);
});
// ═══════════════════════════════════════════════════════════
// USERS
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'users', 'sw.api.users.search(q)', {
sdk: function () { return sw.api.users.search('admin'); },
raw: { method: 'GET', path: '/users/search?q=admin' },
validate: function (r) { var arr = T.unwrapList(r); T.assert(arr.length >= 0, 'expected list'); }
});
// ═══════════════════════════════════════════════════════════
// PRESENCE
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'presence', 'sw.api.presence.heartbeat()', {
sdk: function () { return sw.api.presence.heartbeat(); },
raw: { method: 'POST', path: '/presence/heartbeat', body: {} },
validate: function () { /* 200 OK is sufficient */ }
});
// ═══════════════════════════════════════════════════════════
// USAGE
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'usage', 'sw.api.usage.mine()', {
sdk: function () { return sw.api.usage.mine(); },
raw: { method: 'GET', path: '/usage' },
validate: function (r) { T.assert(typeof r === 'object' || Array.isArray(r), 'expected object or array'); }
s.test('users: sw.api.users.search(q)', async function (t) {
var result = await T.dualTest(
function () { return sw.api.users.search('admin'); },
{ method: 'GET', path: '/users/search?q=admin' },
function (r) { var arr = T.unwrapList(r); T.assert(arr.length >= 0, 'expected list'); }
);
if (result.verdict === 'PASS') return;
if (result.verdict === 'SDK_BUG') t.assert.ok(false, 'SDK_BUG: ' + result.sdkErr);
if (result.verdict === 'ICD_BUG') t.assert.ok(false, 'ICD_BUG: ' + result.rawErr);
if (result.verdict === 'SHAPE_BUG') t.warn('SHAPE_BUG: ' + result.sdkErr);
});
// ═══════════════════════════════════════════════════════════
// GROUPS
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'groups', 'sw.api.groups.mine()', {
sdk: function () { return sw.api.groups.mine(); },
raw: { method: 'GET', path: '/groups/mine' },
validate: function (r) { var arr = T.unwrapList(r); T.assert(arr.length >= 0, 'expected list'); }
s.test('groups: sw.api.groups.mine()', async function (t) {
var result = await T.dualTest(
function () { return sw.api.groups.mine(); },
{ method: 'GET', path: '/groups/mine' },
function (r) { var arr = T.unwrapList(r); T.assert(arr.length >= 0, 'expected list'); }
);
if (result.verdict === 'PASS') return;
if (result.verdict === 'SDK_BUG') t.assert.ok(false, 'SDK_BUG: ' + result.sdkErr);
if (result.verdict === 'ICD_BUG') t.assert.ok(false, 'ICD_BUG: ' + result.rawErr);
if (result.verdict === 'SHAPE_BUG') t.warn('SHAPE_BUG: ' + result.sdkErr);
});
// ═══════════════════════════════════════════════════════════
// TOOLS
// EXTENSIONS
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'tools', 'sw.api.tools.list()', {
sdk: function () { return sw.api.tools.list(); },
raw: { method: 'GET', path: '/tools' },
validate: function (r) { var arr = T.unwrapList(r); T.assert(arr.length >= 0, 'expected list'); }
s.test('extensions: sw.api.get /extensions returns array', async function (t) {
var result = await T.dualTest(
function () { return sw.api.get('/api/v1/extensions'); },
{ method: 'GET', path: '/extensions' },
function (r) {
var arr = Array.isArray(r) ? r : (r && r.data);
T.assert(Array.isArray(arr), 'extensions should be array');
}
);
if (result.verdict === 'PASS') return;
if (result.verdict === 'SDK_BUG') t.assert.ok(false, 'SDK_BUG: ' + result.sdkErr);
if (result.verdict === 'ICD_BUG') t.assert.ok(false, 'ICD_BUG: ' + result.rawErr);
if (result.verdict === 'SHAPE_BUG') t.warn('SHAPE_BUG: ' + result.sdkErr);
});
// ═══════════════════════════════════════════════════════════
// DATA PORTABILITY (KNOWN BUG: deleteAccount wrong method+path)
// ═══════════════════════════════════════════════════════════
await T.test('misc', 'export', 'sw.api.dataPortability.exportMe()', {
sdk: function () { return sw.api.dataPortability.exportMe(); },
raw: { method: 'GET', path: '/export/me' },
validate: function (r) { T.assert(typeof r === 'object', 'expected object'); },
skip: 'empty DB export may 500 — expected in dev'
s.test('export: sw.api.dataPortability.exportMe()', async function (t) {
// skip: empty DB export may 500 — expected in dev
t.warn('SKIP: empty DB export may 500 — expected in dev');
});
// deleteAccount: SDK uses POST /profile/delete, backend is DELETE /me
// We don't actually call delete — just verify the method exists
await T.test('misc', 'export', 'sw.api.dataPortability.deleteAccount exists', async function () {
s.test('export: sw.api.dataPortability.deleteAccount exists', async function (t) {
if (!sw.api.dataPortability) { t.warn('SKIP: sw.api.dataPortability not defined'); return; }
T.assert(typeof sw.api.dataPortability.deleteAccount === 'function',
'deleteAccount should be a function');
// NOTE: SDK calls POST /profile/delete — backend is DELETE /me.