@volter/twin-standard 1.0.96 → 1.0.97

package/client-sdks/bun.lock

@@ -5,6 +5,7 @@
     "": {
       "name": "twin-standard-client-sdks",
       "dependencies": {
+        "@linear/sdk": "86.0.0",
         "@sentry/browser": "10.38.0",
         "@sentry/core": "10.38.0",
         "@sentry/node": "10.38.0",
@@ -23,6 +24,10 @@
 
     "@apm-js-collab/tracing-hooks": ["@apm-js-collab/tracing-hooks@0.3.1", "", { "dependencies": { "@apm-js-collab/code-transformer": "^0.8.0", "debug": "^4.4.1", "module-details-from-path": "^1.0.4" } }, "sha512-Vu1CbmPURlN5fTboVuKMoJjbO5qcq9fA5YXpskx3dXe/zTBvjODFoerw+69rVBlRLrJpwPqSDqEuJDEKIrTldw=="],
 
+    "@graphql-typed-document-node/core": ["@graphql-typed-document-node/core@3.2.0", "", { "peerDependencies": { "graphql": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0" } }, "sha512-mB9oAsNCm9aM3/SOv4YtBMqZbYj10R7dkq8byBqxGY/ncFwhf2oQzMV+LCRlWoDSEBJ3COiR1yeDvMtsoOsuFQ=="],
+
+    "@linear/sdk": ["@linear/sdk@86.0.0", "", { "dependencies": { "@graphql-typed-document-node/core": "^3.2.0" } }, "sha512-Lr47874CGGPCDiPQoKYjcZDWyyu18N8zzEGvss86uzjZaeZrhNsuwKTARswG27VAJ3fPVJAvl/5dPl8QwndSlg=="],
+
     "@opentelemetry/api": ["@opentelemetry/api@1.9.1", "", {}, "sha512-gLyJlPHPZYdAk1JENA9LeHejZe1Ti77/pTeFm/nMXmQH/HFZlcS/O2XJB+L8fkbrNSqhdtlvjBVjxwUYanNH5Q=="],
 
     "@opentelemetry/api-logs": ["@opentelemetry/api-logs@0.211.0", "", { "dependencies": { "@opentelemetry/api": "^1.3.0" } }, "sha512-swFdZq8MCdmdR22jTVGQDhwqDzcI4M10nhjXkLr1EsIzXgZBqm4ZlmmcWsg3TSNf+3mzgOiqveXmBLZuDi2Lgg=="],
@@ -165,6 +170,8 @@
 
     "function-bind": ["function-bind@1.1.2", "", {}, "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA=="],
 
+    "graphql": ["graphql@17.0.2", "", {}, "sha512-FRWbddMxfkjiB7z+aQDWIR+E34xo9I8c9mtK2RPv8PmMzKRvrdsreHL/Ui/TmwHJfhHChEtsFPyMHKI+xuarQQ=="],
+
     "hasown": ["hasown@2.0.4", "", { "dependencies": { "function-bind": "^1.1.2" } }, "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A=="],
 
     "import-in-the-middle": ["import-in-the-middle@2.0.6", "", { "dependencies": { "acorn": "^8.15.0", "acorn-import-attributes": "^1.9.5", "cjs-module-lexer": "^2.2.0", "module-details-from-path": "^1.0.4" } }, "sha512-3vZV3jX0XRFW3EJDTwzWoZa+RH1b8eTTx6YOCjglrLyPuepwoBti1k3L2dKwdCUrnVEfc5CuRuGstaC/uQJJaw=="],

package/client-sdks/package.json

@@ -12,6 +12,7 @@
     "sentry-node-cal-web": "npm:@sentry/node@10.33.0",
     "sentry-node-postiz": "npm:@sentry/node@10.56.0",
     "sentry-node-twenty": "npm:@sentry/node@10.73.0",
-    "resend": "6.6.0"
+    "resend": "6.6.0",
+    "@linear/sdk": "86.0.0"
   }
 }

package/dist/client-sdks/bun.lock

@@ -5,6 +5,7 @@
     "": {
       "name": "twin-standard-client-sdks",
       "dependencies": {
+        "@linear/sdk": "86.0.0",
         "@sentry/browser": "10.38.0",
         "@sentry/core": "10.38.0",
         "@sentry/node": "10.38.0",
@@ -23,6 +24,10 @@
 
     "@apm-js-collab/tracing-hooks": ["@apm-js-collab/tracing-hooks@0.3.1", "", { "dependencies": { "@apm-js-collab/code-transformer": "^0.8.0", "debug": "^4.4.1", "module-details-from-path": "^1.0.4" } }, "sha512-Vu1CbmPURlN5fTboVuKMoJjbO5qcq9fA5YXpskx3dXe/zTBvjODFoerw+69rVBlRLrJpwPqSDqEuJDEKIrTldw=="],
 
+    "@graphql-typed-document-node/core": ["@graphql-typed-document-node/core@3.2.0", "", { "peerDependencies": { "graphql": "^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0" } }, "sha512-mB9oAsNCm9aM3/SOv4YtBMqZbYj10R7dkq8byBqxGY/ncFwhf2oQzMV+LCRlWoDSEBJ3COiR1yeDvMtsoOsuFQ=="],
+
+    "@linear/sdk": ["@linear/sdk@86.0.0", "", { "dependencies": { "@graphql-typed-document-node/core": "^3.2.0" } }, "sha512-Lr47874CGGPCDiPQoKYjcZDWyyu18N8zzEGvss86uzjZaeZrhNsuwKTARswG27VAJ3fPVJAvl/5dPl8QwndSlg=="],
+
     "@opentelemetry/api": ["@opentelemetry/api@1.9.1", "", {}, "sha512-gLyJlPHPZYdAk1JENA9LeHejZe1Ti77/pTeFm/nMXmQH/HFZlcS/O2XJB+L8fkbrNSqhdtlvjBVjxwUYanNH5Q=="],
 
     "@opentelemetry/api-logs": ["@opentelemetry/api-logs@0.211.0", "", { "dependencies": { "@opentelemetry/api": "^1.3.0" } }, "sha512-swFdZq8MCdmdR22jTVGQDhwqDzcI4M10nhjXkLr1EsIzXgZBqm4ZlmmcWsg3TSNf+3mzgOiqveXmBLZuDi2Lgg=="],
@@ -165,6 +170,8 @@
 
     "function-bind": ["function-bind@1.1.2", "", {}, "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA=="],
 
+    "graphql": ["graphql@17.0.2", "", {}, "sha512-FRWbddMxfkjiB7z+aQDWIR+E34xo9I8c9mtK2RPv8PmMzKRvrdsreHL/Ui/TmwHJfhHChEtsFPyMHKI+xuarQQ=="],
+
     "hasown": ["hasown@2.0.4", "", { "dependencies": { "function-bind": "^1.1.2" } }, "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A=="],
 
     "import-in-the-middle": ["import-in-the-middle@2.0.6", "", { "dependencies": { "acorn": "^8.15.0", "acorn-import-attributes": "^1.9.5", "cjs-module-lexer": "^2.2.0", "module-details-from-path": "^1.0.4" } }, "sha512-3vZV3jX0XRFW3EJDTwzWoZa+RH1b8eTTx6YOCjglrLyPuepwoBti1k3L2dKwdCUrnVEfc5CuRuGstaC/uQJJaw=="],

package/dist/client-sdks/package.json

@@ -12,6 +12,7 @@
     "sentry-node-cal-web": "npm:@sentry/node@10.33.0",
     "sentry-node-postiz": "npm:@sentry/node@10.56.0",
     "sentry-node-twenty": "npm:@sentry/node@10.73.0",
-    "resend": "6.6.0"
+    "resend": "6.6.0",
+    "@linear/sdk": "86.0.0"
   }
 }

package/dist/src/clients/linear.d.ts

@@ -0,0 +1,2 @@
+import type { ClientCase } from './harness.js';
+export declare const cases: ClientCase[];

package/dist/src/clients/linear.js

@@ -0,0 +1,48 @@
+// The dependency demand's official Linear SDK pin, unchanged, over the World's GraphQL routing.
+import { createRequire } from 'node:module';
+import { standardPackageFile } from "../package-file.js";
+const sdk = createRequire(new URL('package.json', standardPackageFile('client-sdks/')));
+async function setup(c) {
+    const door = async (path, body) => {
+        const answer = await c.fetch(`https://${c.host}${path}`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body) });
+        if (!answer.ok)
+            throw new Error(`${path} answered ${answer.status}: ${await answer.text()}`);
+        return await answer.json();
+    };
+    const made = await door('/_twin/workspaces', { name: 'SDK workspace', urlKey: 'sdk-workspace', owner: { name: 'SDK owner', email: 'owner@linear-sdk.test', password: 'synthetic-sdk-password' } });
+    const key = await door('/_twin/api-keys', { email: 'owner@linear-sdk.test', label: 'SDK case' });
+    return { owner: made.owner, apiKey: key.key, client: new (sdk('@linear/sdk').LinearClient)({ apiKey: key.key }) };
+}
+export const cases = [{
+        id: 'issue-create-update-and-read',
+        asks: 'the SDK reads its full viewer/team/issue models, writes and reads an issue, and observes native counts after archive',
+        source: 'https://linear.app/developers/sdk-fetching-and-modifying-data "To create a model, call the Linear Client mutation and pass an input object:"',
+        async run(c) {
+            const { owner, apiKey, client } = await setup(c);
+            const me = await client.viewer;
+            if (me.id !== owner || me.email !== 'owner@linear-sdk.test')
+                return ['viewer does not identify the key owner'];
+            const madeTeam = await client.createTeam({ name: 'SDK team', key: 'SDK' });
+            const team = await madeTeam.team;
+            if (!madeTeam.success || !team?.id)
+                return ['createTeam returned no successful team'];
+            const madeIssue = await client.createIssue({ teamId: team.id, title: 'SDK issue', description: 'Synthetic issue body' });
+            const issue = await madeIssue.issue;
+            if (!madeIssue.success || !issue?.id || issue.title !== 'SDK issue')
+                return ['createIssue returned no successful issue'];
+            const updated = await client.updateIssue(issue.id, { title: 'SDK issue updated', priority: 2 });
+            if (!updated.success)
+                return ['updateIssue did not succeed'];
+            const got = await client.issue(issue.id);
+            if (got.id !== issue.id || got.title !== 'SDK issue updated' || got.description !== 'Synthetic issue body' || got.priority !== 2)
+                return ['issue did not preserve its id, changed title/priority and original description'];
+            if ((await client.viewer).createdIssueCount !== 1 || (await client.team(team.id)).issueCount !== 1)
+                return ['created issue counts do not follow the written issue'];
+            const archived = await client.archiveIssue(issue.id);
+            if (!archived.success || (await client.team(team.id)).issueCount !== 0 || (await client.viewer).createdIssueCount !== 1)
+                return ['archive did not update the active team count while preserving the creator count'];
+            const response = await c.fetch(`https://${c.host}/graphql`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: String(apiKey) }, body: JSON.stringify({ query: 'query($id: String!) { team(id: $id) { issueCount(includeArchived: true) } }', variables: { id: team.id } }) });
+            const total = await response.json();
+            return !total.errors?.length && total.data?.team?.issueCount === 1 ? [] : ['includeArchived does not include the stored archived issue'];
+        },
+    }];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.96",
+  "version": "1.0.97",
   "description": "The Protocol 3 standard for Volter twin packs: the criteria a pack is graded by, the grader, the gate a pack repository and the twin catalog run on every change and submission, and the spec derivation the grade checks against. Pin a version: every place a pack is judged judges by that standard.",
   "keywords": [
     "twin",
@@ -75,7 +75,7 @@
     "yaml": "2.9.0"
   },
   "peerDependencies": {
-    "@volter/world-core": "3.0.104",
+    "@volter/world-core": "3.0.105",
     "@volter/world-runtime": "*",
     "playwright": "^1.63.0"
   },

package/src/clients/linear.ts

@@ -0,0 +1,41 @@
+// The dependency demand's official Linear SDK pin, unchanged, over the World's GraphQL routing.
+import { createRequire } from 'node:module';
+import { standardPackageFile } from '../package-file.ts';
+import type { ClientCase, ClientContext } from './harness.ts';
+const sdk = createRequire(new URL('package.json', standardPackageFile('client-sdks/')));
+async function setup(c: ClientContext) {
+  const door = async (path: string, body: unknown) => {
+    const answer = await c.fetch(`https://${c.host}${path}`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body) });
+    if (!answer.ok) throw new Error(`${path} answered ${answer.status}: ${await answer.text()}`);
+    return await answer.json() as Record<string, unknown>;
+  };
+  const made = await door('/_twin/workspaces', { name: 'SDK workspace', urlKey: 'sdk-workspace', owner: { name: 'SDK owner', email: 'owner@linear-sdk.test', password: 'synthetic-sdk-password' } });
+  const key = await door('/_twin/api-keys', { email: 'owner@linear-sdk.test', label: 'SDK case' });
+  return { owner: made.owner, apiKey: key.key, client: new (sdk('@linear/sdk').LinearClient)({ apiKey: key.key }) };
+}
+export const cases: ClientCase[] = [{
+  id: 'issue-create-update-and-read',
+  asks: 'the SDK reads its full viewer/team/issue models, writes and reads an issue, and observes native counts after archive',
+  source: 'https://linear.app/developers/sdk-fetching-and-modifying-data "To create a model, call the Linear Client mutation and pass an input object:"',
+  async run(c) {
+    const { owner, apiKey, client } = await setup(c);
+    const me = await client.viewer;
+    if (me.id !== owner || me.email !== 'owner@linear-sdk.test') return ['viewer does not identify the key owner'];
+    const madeTeam = await client.createTeam({ name: 'SDK team', key: 'SDK' });
+    const team = await madeTeam.team;
+    if (!madeTeam.success || !team?.id) return ['createTeam returned no successful team'];
+    const madeIssue = await client.createIssue({ teamId: team.id, title: 'SDK issue', description: 'Synthetic issue body' });
+    const issue = await madeIssue.issue;
+    if (!madeIssue.success || !issue?.id || issue.title !== 'SDK issue') return ['createIssue returned no successful issue'];
+    const updated = await client.updateIssue(issue.id, { title: 'SDK issue updated', priority: 2 });
+    if (!updated.success) return ['updateIssue did not succeed'];
+    const got = await client.issue(issue.id);
+    if (got.id !== issue.id || got.title !== 'SDK issue updated' || got.description !== 'Synthetic issue body' || got.priority !== 2) return ['issue did not preserve its id, changed title/priority and original description'];
+    if ((await client.viewer).createdIssueCount !== 1 || (await client.team(team.id)).issueCount !== 1) return ['created issue counts do not follow the written issue'];
+    const archived = await client.archiveIssue(issue.id);
+    if (!archived.success || (await client.team(team.id)).issueCount !== 0 || (await client.viewer).createdIssueCount !== 1) return ['archive did not update the active team count while preserving the creator count'];
+    const response = await c.fetch(`https://${c.host}/graphql`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: String(apiKey) }, body: JSON.stringify({ query: 'query($id: String!) { team(id: $id) { issueCount(includeArchived: true) } }', variables: { id: team.id } }) });
+    const total = await response.json() as { errors?: unknown[]; data?: { team?: { issueCount?: number } } };
+    return !total.errors?.length && total.data?.team?.issueCount === 1 ? [] : ['includeArchived does not include the stored archived issue'];
+  },
+}];