@pixelbyte-software/pixcode 1.54.10 → 1.55.0

package/scripts/smoke/git-install-update.mjs

@@ -1,255 +1,255 @@
-import assert from 'node:assert/strict';
-import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-
-const serverIndex = fs.readFileSync('server/index.js', 'utf8');
-const modal = fs.readFileSync('src/components/version-upgrade/view/VersionUpgradeModal.tsx', 'utf8');
-const updater = fs.readFileSync('scripts/update-git-install.mjs', 'utf8');
-const updaterPath = path.resolve('scripts/update-git-install.mjs');
-
-assert.match(
-  serverIndex,
-  /update-git-install\.mjs/,
-  'Git install updates should use the safe updater script instead of raw git pull.',
-);
-
-assert.doesNotMatch(
-  serverIndex,
-  /git checkout main && git pull && npm install/,
-  'Server update command should not use the brittle raw git checkout/pull/install chain.',
-);
-
-assert.match(
-  serverIndex,
-  /updateCommandLabel[\s\S]*Pixcode source update/,
-  'Server update stream should describe git installs with product language instead of an internal script command.',
-);
-
-assert.match(
-  modal,
-  /versionUpdate\.pixcodeUpgradeCommand/,
-  'Version modal should show the user-facing Pixcode update command.',
-);
-
-assert.doesNotMatch(
-  modal,
-  /node scripts\/update-git-install\.mjs/,
-  'Version modal should not expose the internal git updater script as manual product guidance.',
-);
-
-assert.match(
-  fs.readFileSync('server/cli.js', 'utf8'),
-  /update-git-install\.mjs[\s\S]*installMode === 'git'[\s\S]*updateGitPackage/,
-  'pixcode update should drive the safe git updater for source installs.',
-);
-
-assert.match(
-  updater,
-  /stash[\s\S]*push[\s\S]*--include-untracked[\s\S]*--message/,
-  'Safe updater should stash dirty tracked and untracked files before updating.',
-);
-
-assert.match(
-  updater,
-  /branch[\s\S]*backupBranch/,
-  'Safe updater should preserve divergent local commits in a backup branch.',
-);
-
-assert.match(
-  updater,
-  /reset[\s\S]*--hard[\s\S]*origin\/main/,
-  'Safe updater should be able to normalize a divergent install checkout after preserving it.',
-);
-
-assert.match(
-  updater,
-  /shouldRunNpmInstall/,
-  'Safe updater should decide whether dependency reconciliation is needed from changed files.',
-);
-
-assert.match(
-  updater,
-  /Dependencies unchanged; skipping npm install\./,
-  'Safe updater should skip npm install when package manifests did not change.',
-);
-
-assert.match(
-  updater,
-  /shouldRunBuild/,
-  'Safe updater should decide whether source rebuild is needed from changed files.',
-);
-
-assert.match(
-  updater,
-  /Build inputs unchanged; skipping build\./,
-  'Safe updater should skip build when only non-runtime files changed.',
-);
-
-function makeTempRepo(name) {
-  const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), `pixcode-git-update-${name}-`));
-  const origin = path.join(tempRoot, 'origin.git');
-  const source = path.join(tempRoot, 'source');
-  const install = path.join(tempRoot, 'install');
-
-  fs.mkdirSync(source, { recursive: true });
-  run('git', ['init', '--bare', origin], tempRoot);
-  run('git', ['init', '-b', 'main'], source);
-  writePackage(source, '1.0.0');
-  fs.mkdirSync(path.join(source, 'src'), { recursive: true });
-  fs.writeFileSync(path.join(source, 'src', 'app.js'), 'old\n');
-  fs.writeFileSync(path.join(source, 'README.md'), 'old docs\n');
-  fs.writeFileSync(path.join(source, 'tracked.txt'), 'old\n');
-  run('git', ['add', '.'], source);
-  run('git', ['commit', '-m', 'initial'], source);
-  run('git', ['remote', 'add', 'origin', origin], source);
-  run('git', ['push', '-u', 'origin', 'main'], source);
-  run('git', ['symbolic-ref', 'HEAD', 'refs/heads/main'], origin);
-  run('git', ['clone', origin, install], tempRoot);
-
-  return { origin, source, install };
-}
-
-function run(command, args, cwd) {
-  const result = spawnSync(command, args, {
-    cwd,
-    encoding: 'utf8',
-    env: {
-      ...process.env,
-      GIT_AUTHOR_NAME: 'Pixcode Smoke',
-      GIT_AUTHOR_EMAIL: 'smoke@pixcode.local',
-      GIT_COMMITTER_NAME: 'Pixcode Smoke',
-      GIT_COMMITTER_EMAIL: 'smoke@pixcode.local',
-    },
-  });
-
-  assert.equal(
-    result.status,
-    0,
-    `${command} ${args.join(' ')} failed\nstdout:\n${result.stdout}\nstderr:\n${result.stderr}`,
-  );
-
-  return `${result.stdout}${result.stderr}`.trim();
-}
-
-function writePackage(root, version, dependencies = {}) {
-  fs.writeFileSync(
-    path.join(root, 'package.json'),
-    JSON.stringify({
-      name: 'pixcode-update-smoke',
-      version,
-      scripts: {
-        preinstall: 'node -e "require(\\"node:fs\\").writeFileSync(\\"install-ran.txt\\", \\"install\\")"',
-        build: 'node -e "require(\\"node:fs\\").writeFileSync(\\"built.txt\\", \\"built\\")"',
-      },
-      dependencies,
-    }, null, 2),
-  );
-  fs.writeFileSync(
-    path.join(root, 'package-lock.json'),
-    JSON.stringify({
-      name: 'pixcode-update-smoke',
-      version,
-      lockfileVersion: 3,
-      requires: true,
-      packages: {
-        '': {
-          name: 'pixcode-update-smoke',
-          version,
-        },
-      },
-    }, null, 2),
-  );
-}
-
-{
-  const { source, install } = makeTempRepo('deps');
-
-  fs.mkdirSync(path.join(source, 'local-dep'), { recursive: true });
-  fs.writeFileSync(
-    path.join(source, 'local-dep', 'package.json'),
-    JSON.stringify({ name: 'pixcode-smoke-local-dep', version: '1.0.0' }, null, 2),
-  );
-  writePackage(source, '1.0.1', { 'pixcode-smoke-local-dep': 'file:./local-dep' });
-  fs.writeFileSync(path.join(source, 'tracked.txt'), 'new\n');
-  run('git', ['add', '.'], source);
-  run('git', ['commit', '-m', 'dependency update'], source);
-  run('git', ['push', 'origin', 'main'], source);
-
-  fs.writeFileSync(path.join(install, 'tracked.txt'), 'local dirty change\n');
-  fs.writeFileSync(path.join(install, 'untracked.txt'), 'local untracked change\n');
-  run(process.execPath, [updaterPath], install);
-
-  assert.equal(
-    JSON.parse(fs.readFileSync(path.join(install, 'package.json'), 'utf8')).version,
-    '1.0.1',
-    'Safe updater should fast-forward the install checkout.',
-  );
-  assert.equal(
-    fs.readFileSync(path.join(install, 'tracked.txt'), 'utf8'),
-    'new\n',
-    'Safe updater should apply the remote tracked file after stashing local edits.',
-  );
-  assert.match(
-    run('git', ['stash', 'list'], install),
-    /pixcode-auto-update-/,
-    'Safe updater should leave local dirty files recoverable in git stash.',
-  );
-  assert.equal(
-    fs.readFileSync(path.join(install, 'install-ran.txt'), 'utf8'),
-    'install',
-    'Dependency updates should run npm install.',
-  );
-  assert.equal(
-    fs.readFileSync(path.join(install, 'built.txt'), 'utf8'),
-    'built',
-    'Safe updater should run the repository build after dependency updates.',
-  );
-}
-
-{
-  const { source, install } = makeTempRepo('source');
-
-  fs.writeFileSync(path.join(source, 'src', 'app.js'), 'new source\n');
-  run('git', ['add', '.'], source);
-  run('git', ['commit', '-m', 'source update'], source);
-  run('git', ['push', 'origin', 'main'], source);
-
-  run(process.execPath, [updaterPath], install);
-
-  assert.equal(
-    fs.existsSync(path.join(install, 'install-ran.txt')),
-    false,
-    'Source-only updates should skip npm install.',
-  );
-  assert.equal(
-    fs.readFileSync(path.join(install, 'built.txt'), 'utf8'),
-    'built',
-    'Source-only updates should produce a fresh build output.',
-  );
-}
-
-{
-  const { source, install } = makeTempRepo('docs');
-
-  fs.writeFileSync(path.join(source, 'README.md'), 'new docs\n');
-  run('git', ['add', '.'], source);
-  run('git', ['commit', '-m', 'docs update'], source);
-  run('git', ['push', 'origin', 'main'], source);
-
-  run(process.execPath, [updaterPath], install);
-
-  assert.equal(
-    fs.existsSync(path.join(install, 'install-ran.txt')),
-    false,
-    'Docs-only updates should skip npm install.',
-  );
-  assert.equal(
-    fs.existsSync(path.join(install, 'built.txt')),
-    false,
-    'Docs-only updates should not create build output.',
-  );
-}
-
-console.log('git install update smoke passed');
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+const serverIndex = fs.readFileSync('server/index.js', 'utf8');
+const modal = fs.readFileSync('src/components/version-upgrade/view/VersionUpgradeModal.tsx', 'utf8');
+const updater = fs.readFileSync('scripts/update-git-install.mjs', 'utf8');
+const updaterPath = path.resolve('scripts/update-git-install.mjs');
+
+assert.match(
+  serverIndex,
+  /update-git-install\.mjs/,
+  'Git install updates should use the safe updater script instead of raw git pull.',
+);
+
+assert.doesNotMatch(
+  serverIndex,
+  /git checkout main && git pull && npm install/,
+  'Server update command should not use the brittle raw git checkout/pull/install chain.',
+);
+
+assert.match(
+  serverIndex,
+  /updateCommandLabel[\s\S]*Pixcode source update/,
+  'Server update stream should describe git installs with product language instead of an internal script command.',
+);
+
+assert.match(
+  modal,
+  /versionUpdate\.pixcodeUpgradeCommand/,
+  'Version modal should show the user-facing Pixcode update command.',
+);
+
+assert.doesNotMatch(
+  modal,
+  /node scripts\/update-git-install\.mjs/,
+  'Version modal should not expose the internal git updater script as manual product guidance.',
+);
+
+assert.match(
+  fs.readFileSync('server/cli.js', 'utf8'),
+  /update-git-install\.mjs[\s\S]*installMode === 'git'[\s\S]*updateGitPackage/,
+  'pixcode update should drive the safe git updater for source installs.',
+);
+
+assert.match(
+  updater,
+  /stash[\s\S]*push[\s\S]*--include-untracked[\s\S]*--message/,
+  'Safe updater should stash dirty tracked and untracked files before updating.',
+);
+
+assert.match(
+  updater,
+  /branch[\s\S]*backupBranch/,
+  'Safe updater should preserve divergent local commits in a backup branch.',
+);
+
+assert.match(
+  updater,
+  /reset[\s\S]*--hard[\s\S]*origin\/main/,
+  'Safe updater should be able to normalize a divergent install checkout after preserving it.',
+);
+
+assert.match(
+  updater,
+  /shouldRunNpmInstall/,
+  'Safe updater should decide whether dependency reconciliation is needed from changed files.',
+);
+
+assert.match(
+  updater,
+  /Dependencies unchanged; skipping npm install\./,
+  'Safe updater should skip npm install when package manifests did not change.',
+);
+
+assert.match(
+  updater,
+  /shouldRunBuild/,
+  'Safe updater should decide whether source rebuild is needed from changed files.',
+);
+
+assert.match(
+  updater,
+  /Build inputs unchanged; skipping build\./,
+  'Safe updater should skip build when only non-runtime files changed.',
+);
+
+function makeTempRepo(name) {
+  const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), `pixcode-git-update-${name}-`));
+  const origin = path.join(tempRoot, 'origin.git');
+  const source = path.join(tempRoot, 'source');
+  const install = path.join(tempRoot, 'install');
+
+  fs.mkdirSync(source, { recursive: true });
+  run('git', ['init', '--bare', origin], tempRoot);
+  run('git', ['init', '-b', 'main'], source);
+  writePackage(source, '1.0.0');
+  fs.mkdirSync(path.join(source, 'src'), { recursive: true });
+  fs.writeFileSync(path.join(source, 'src', 'app.js'), 'old\n');
+  fs.writeFileSync(path.join(source, 'README.md'), 'old docs\n');
+  fs.writeFileSync(path.join(source, 'tracked.txt'), 'old\n');
+  run('git', ['add', '.'], source);
+  run('git', ['commit', '-m', 'initial'], source);
+  run('git', ['remote', 'add', 'origin', origin], source);
+  run('git', ['push', '-u', 'origin', 'main'], source);
+  run('git', ['symbolic-ref', 'HEAD', 'refs/heads/main'], origin);
+  run('git', ['clone', origin, install], tempRoot);
+
+  return { origin, source, install };
+}
+
+function run(command, args, cwd) {
+  const result = spawnSync(command, args, {
+    cwd,
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      GIT_AUTHOR_NAME: 'Pixcode Smoke',
+      GIT_AUTHOR_EMAIL: 'smoke@pixcode.local',
+      GIT_COMMITTER_NAME: 'Pixcode Smoke',
+      GIT_COMMITTER_EMAIL: 'smoke@pixcode.local',
+    },
+  });
+
+  assert.equal(
+    result.status,
+    0,
+    `${command} ${args.join(' ')} failed\nstdout:\n${result.stdout}\nstderr:\n${result.stderr}`,
+  );
+
+  return `${result.stdout}${result.stderr}`.trim();
+}
+
+function writePackage(root, version, dependencies = {}) {
+  fs.writeFileSync(
+    path.join(root, 'package.json'),
+    JSON.stringify({
+      name: 'pixcode-update-smoke',
+      version,
+      scripts: {
+        preinstall: 'node -e "require(\\"node:fs\\").writeFileSync(\\"install-ran.txt\\", \\"install\\")"',
+        build: 'node -e "require(\\"node:fs\\").writeFileSync(\\"built.txt\\", \\"built\\")"',
+      },
+      dependencies,
+    }, null, 2),
+  );
+  fs.writeFileSync(
+    path.join(root, 'package-lock.json'),
+    JSON.stringify({
+      name: 'pixcode-update-smoke',
+      version,
+      lockfileVersion: 3,
+      requires: true,
+      packages: {
+        '': {
+          name: 'pixcode-update-smoke',
+          version,
+        },
+      },
+    }, null, 2),
+  );
+}
+
+{
+  const { source, install } = makeTempRepo('deps');
+
+  fs.mkdirSync(path.join(source, 'local-dep'), { recursive: true });
+  fs.writeFileSync(
+    path.join(source, 'local-dep', 'package.json'),
+    JSON.stringify({ name: 'pixcode-smoke-local-dep', version: '1.0.0' }, null, 2),
+  );
+  writePackage(source, '1.0.1', { 'pixcode-smoke-local-dep': 'file:./local-dep' });
+  fs.writeFileSync(path.join(source, 'tracked.txt'), 'new\n');
+  run('git', ['add', '.'], source);
+  run('git', ['commit', '-m', 'dependency update'], source);
+  run('git', ['push', 'origin', 'main'], source);
+
+  fs.writeFileSync(path.join(install, 'tracked.txt'), 'local dirty change\n');
+  fs.writeFileSync(path.join(install, 'untracked.txt'), 'local untracked change\n');
+  run(process.execPath, [updaterPath], install);
+
+  assert.equal(
+    JSON.parse(fs.readFileSync(path.join(install, 'package.json'), 'utf8')).version,
+    '1.0.1',
+    'Safe updater should fast-forward the install checkout.',
+  );
+  assert.equal(
+    fs.readFileSync(path.join(install, 'tracked.txt'), 'utf8'),
+    'new\n',
+    'Safe updater should apply the remote tracked file after stashing local edits.',
+  );
+  assert.match(
+    run('git', ['stash', 'list'], install),
+    /pixcode-auto-update-/,
+    'Safe updater should leave local dirty files recoverable in git stash.',
+  );
+  assert.equal(
+    fs.readFileSync(path.join(install, 'install-ran.txt'), 'utf8'),
+    'install',
+    'Dependency updates should run npm install.',
+  );
+  assert.equal(
+    fs.readFileSync(path.join(install, 'built.txt'), 'utf8'),
+    'built',
+    'Safe updater should run the repository build after dependency updates.',
+  );
+}
+
+{
+  const { source, install } = makeTempRepo('source');
+
+  fs.writeFileSync(path.join(source, 'src', 'app.js'), 'new source\n');
+  run('git', ['add', '.'], source);
+  run('git', ['commit', '-m', 'source update'], source);
+  run('git', ['push', 'origin', 'main'], source);
+
+  run(process.execPath, [updaterPath], install);
+
+  assert.equal(
+    fs.existsSync(path.join(install, 'install-ran.txt')),
+    false,
+    'Source-only updates should skip npm install.',
+  );
+  assert.equal(
+    fs.readFileSync(path.join(install, 'built.txt'), 'utf8'),
+    'built',
+    'Source-only updates should produce a fresh build output.',
+  );
+}
+
+{
+  const { source, install } = makeTempRepo('docs');
+
+  fs.writeFileSync(path.join(source, 'README.md'), 'new docs\n');
+  run('git', ['add', '.'], source);
+  run('git', ['commit', '-m', 'docs update'], source);
+  run('git', ['push', 'origin', 'main'], source);
+
+  run(process.execPath, [updaterPath], install);
+
+  assert.equal(
+    fs.existsSync(path.join(install, 'install-ran.txt')),
+    false,
+    'Docs-only updates should skip npm install.',
+  );
+  assert.equal(
+    fs.existsSync(path.join(install, 'built.txt')),
+    false,
+    'Docs-only updates should not create build output.',
+  );
+}
+
+console.log('git install update smoke passed');

package/scripts/smoke/handoff-artifact-protocol.mjs

@@ -1,50 +1,50 @@
-#!/usr/bin/env node
-
-import assert from 'node:assert/strict';
-import fs from 'node:fs';
-import path from 'node:path';
-
-const root = process.cwd();
-
-function read(relativePath) {
-  return fs.readFileSync(path.join(root, relativePath), 'utf8');
-}
-
-const handoffSource = read('server/modules/orchestration/workflows/handoff-artifact.ts');
-assert.match(handoffSource, /PIXCODE_HANDOFF_PROTOCOL/, 'Handoff artifacts should declare a stable protocol id.');
-assert.match(handoffSource, /pixcode\.handoff\.v1/, 'Handoff artifacts should use the v1 protocol id.');
-assert.match(handoffSource, /taskStatus/, 'Handoff schema should require task status.');
-assert.match(handoffSource, /contextSummary/, 'Handoff schema should require compacted context summary.');
-assert.match(handoffSource, /changedFiles/, 'Handoff schema should require changed files.');
-assert.match(handoffSource, /blockers/, 'Handoff schema should require blockers.');
-assert.match(handoffSource, /nextAction/, 'Handoff schema should require the requested next action.');
-assert.match(handoffSource, /parseHandoffArtifact/, 'Handoff artifacts should have parser/validation logic.');
-assert.match(handoffSource, /formatHandoffArtifactForContext/, 'Handoff artifacts should be formatted for downstream agent context.');
-assert.match(handoffSource, /handoffArtifactToWorkflowArtifact/, 'Handoff artifacts should persist as workflow artifacts.');
-
-const runnerSource = read('server/modules/orchestration/workflows/workflow-runner.ts');
-assert.match(runnerSource, /requiresHandoffArtifact/, 'Workflow runner should detect handoff nodes that require artifacts.');
-assert.match(runnerSource, /parseHandoffArtifact/, 'Workflow runner should validate handoff node output.');
-assert.match(runnerSource, /handoffArtifactToWorkflowArtifact/, 'Workflow runner should persist structured handoff artifacts.');
-assert.match(runnerSource, /formatHandoffArtifactForContext/, 'Workflow runner should pass structured handoff context downstream.');
-assert.match(runnerSource, /Invalid handoff artifact/, 'Invalid handoff artifacts should fail visibly.');
-assert.match(runnerSource, /"protocol": "pixcode\.handoff\.v1"/, 'Handoff prompts should request the protocol JSON shape.');
-
-const workflowTypes = read('server/modules/orchestration/workflows/workflow.types.ts');
-assert.match(workflowTypes, /WorkflowHandoffArtifact/, 'Workflow run types should expose handoff artifacts.');
-assert.match(workflowTypes, /handoffArtifact\?: WorkflowHandoffArtifact/, 'Node runs should persist the validated handoff artifact.');
-
-const traceSource = read('server/modules/orchestration/workflows/workflow-trace.ts');
-assert.match(traceSource, /handoff-artifact/, 'Trace timeline should identify handoff artifacts.');
-assert.match(traceSource, /workflow\.trace\.handoffArtifact/, 'Trace timeline should label handoff artifacts.');
-
-const nodeStream = read('src/components/orchestration/workflows/WorkflowNodeStream.tsx');
-assert.match(nodeStream, /handoff-artifact/, 'Workflow UI should render handoff artifacts.');
-assert.match(nodeStream, /orchestration\.artifact\.handoff/, 'Workflow UI should label handoff artifacts.');
-
-const en = read('src/i18n/locales/en/common.json');
-const tr = read('src/i18n/locales/tr/common.json');
-assert.match(en, /"handoff": "Handoff artifact"/, 'English UI should label handoff artifacts.');
-assert.match(tr, /"handoff": "Handoff artifact"/, 'Turkish UI should label handoff artifacts.');
-
-console.log('handoff artifact protocol smoke passed');
+#!/usr/bin/env node
+
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import path from 'node:path';
+
+const root = process.cwd();
+
+function read(relativePath) {
+  return fs.readFileSync(path.join(root, relativePath), 'utf8');
+}
+
+const handoffSource = read('server/modules/orchestration/workflows/handoff-artifact.ts');
+assert.match(handoffSource, /PIXCODE_HANDOFF_PROTOCOL/, 'Handoff artifacts should declare a stable protocol id.');
+assert.match(handoffSource, /pixcode\.handoff\.v1/, 'Handoff artifacts should use the v1 protocol id.');
+assert.match(handoffSource, /taskStatus/, 'Handoff schema should require task status.');
+assert.match(handoffSource, /contextSummary/, 'Handoff schema should require compacted context summary.');
+assert.match(handoffSource, /changedFiles/, 'Handoff schema should require changed files.');
+assert.match(handoffSource, /blockers/, 'Handoff schema should require blockers.');
+assert.match(handoffSource, /nextAction/, 'Handoff schema should require the requested next action.');
+assert.match(handoffSource, /parseHandoffArtifact/, 'Handoff artifacts should have parser/validation logic.');
+assert.match(handoffSource, /formatHandoffArtifactForContext/, 'Handoff artifacts should be formatted for downstream agent context.');
+assert.match(handoffSource, /handoffArtifactToWorkflowArtifact/, 'Handoff artifacts should persist as workflow artifacts.');
+
+const runnerSource = read('server/modules/orchestration/workflows/workflow-runner.ts');
+assert.match(runnerSource, /requiresHandoffArtifact/, 'Workflow runner should detect handoff nodes that require artifacts.');
+assert.match(runnerSource, /parseHandoffArtifact/, 'Workflow runner should validate handoff node output.');
+assert.match(runnerSource, /handoffArtifactToWorkflowArtifact/, 'Workflow runner should persist structured handoff artifacts.');
+assert.match(runnerSource, /formatHandoffArtifactForContext/, 'Workflow runner should pass structured handoff context downstream.');
+assert.match(runnerSource, /Invalid handoff artifact/, 'Invalid handoff artifacts should fail visibly.');
+assert.match(runnerSource, /"protocol": "pixcode\.handoff\.v1"/, 'Handoff prompts should request the protocol JSON shape.');
+
+const workflowTypes = read('server/modules/orchestration/workflows/workflow.types.ts');
+assert.match(workflowTypes, /WorkflowHandoffArtifact/, 'Workflow run types should expose handoff artifacts.');
+assert.match(workflowTypes, /handoffArtifact\?: WorkflowHandoffArtifact/, 'Node runs should persist the validated handoff artifact.');
+
+const traceSource = read('server/modules/orchestration/workflows/workflow-trace.ts');
+assert.match(traceSource, /handoff-artifact/, 'Trace timeline should identify handoff artifacts.');
+assert.match(traceSource, /workflow\.trace\.handoffArtifact/, 'Trace timeline should label handoff artifacts.');
+
+const nodeStream = read('src/components/orchestration/workflows/WorkflowNodeStream.tsx');
+assert.match(nodeStream, /handoff-artifact/, 'Workflow UI should render handoff artifacts.');
+assert.match(nodeStream, /orchestration\.artifact\.handoff/, 'Workflow UI should label handoff artifacts.');
+
+const en = read('src/i18n/locales/en/common.json');
+const tr = read('src/i18n/locales/tr/common.json');
+assert.match(en, /"handoff": "Handoff artifact"/, 'English UI should label handoff artifacts.');
+assert.match(tr, /"handoff": "Handoff artifact"/, 'Turkish UI should label handoff artifacts.');
+
+console.log('handoff artifact protocol smoke passed');