Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

3.8 KB
Raw Blame
/**
 * toRecordRelativeAssetPath (#2895 importer follow-up): pure path-rebasing
 * helper used by walk.js to normalize source-pipeline-relative asset paths
 * embedded in imported manifests down to the record-relative form PortOS's
 * own client reads. No PATHS/spriteDir dependency — kept dependency-free so
 * this suite runs with zero mocking.
 */

import { describe, it, expect } from 'vitest';
import {
  canonicalizeImportedRunPath,
  canonicalizeImportedRunPathValue,
  deepCanonicalizeImportedRunPaths,
  toRecordRelativeAssetPath,
} from './paths.js';

describe('toRecordRelativeAssetPath', () => {
  it('strips the source-repo marker for this record', () => {
    expect(toRecordRelativeAssetPath('pioneer', 'art-source/sprites/pioneer/grok/walk-east-abc/generated/strip.png'))
      .toBe('grok/walk-east-abc/generated/strip.png');
  });

  it('passes through an already record-relative path unchanged', () => {
    expect(toRecordRelativeAssetPath('pioneer', 'grok/walk-east-abc/generated/strip.png'))
      .toBe('grok/walk-east-abc/generated/strip.png');
  });

  it('strips a leading slash on an already record-relative path (matches importer.js relToCharacterDir)', () => {
    expect(toRecordRelativeAssetPath('pioneer', '/grok/walk-east-abc/generated/strip.png'))
      .toBe('grok/walk-east-abc/generated/strip.png');
  });

  it('rejects a repo-anchored path outside this record (provenance, not a copied asset)', () => {
    expect(toRecordRelativeAssetPath('pioneer', 'art-pipeline/sprite-manager/animation_postprocess.py')).toBeNull();
    expect(toRecordRelativeAssetPath('pioneer', 'game/assets/sprites/pioneer/pioneer-animation-atlas.png')).toBeNull();
  });

  it('rejects the marker for a DIFFERENT record id (cross-record confinement)', () => {
    expect(toRecordRelativeAssetPath('pioneer', 'art-source/sprites/trailhand/reference/main.png')).toBeNull();
  });

  it('rejects traversal segments', () => {
    expect(toRecordRelativeAssetPath('pioneer', '../../etc/passwd')).toBeNull();
    expect(toRecordRelativeAssetPath('pioneer', 'grok/../../../etc/passwd')).toBeNull();
  });

  it('rejects empty path segments', () => {
    expect(toRecordRelativeAssetPath('pioneer', 'grok//strip.png')).toBeNull();
  });

  it('rejects missing/empty/non-string input', () => {
    expect(toRecordRelativeAssetPath('pioneer', '')).toBeNull();
    expect(toRecordRelativeAssetPath('pioneer', null)).toBeNull();
    expect(toRecordRelativeAssetPath('pioneer', undefined)).toBeNull();
    expect(toRecordRelativeAssetPath('pioneer', 42)).toBeNull();
  });
});

describe('imported run-layout normalization', () => {
  it('uses runs/ for record-relative imported run destinations', () => {
    expect(canonicalizeImportedRunPath('grok/walk-east-abc/generated/source-video.mp4'))
      .toBe('runs/walk-east-abc/generated/source-video.mp4');
    expect(canonicalizeImportedRunPath('runs/walk-east-abc/generated/source-video.mp4'))
      .toBe('runs/walk-east-abc/generated/source-video.mp4');
    expect(canonicalizeImportedRunPath('imagegen/v19/strip.png')).toBe('imagegen/v19/strip.png');
  });

  it('rewrites only path-shaped values, including nested source-anchored paths', () => {
    const id = 'pioneer';
    expect(canonicalizeImportedRunPathValue(id, `art-source/sprites/${id}/grok/walk-east-abc/animation-run.json`))
      .toBe(`art-source/sprites/${id}/runs/walk-east-abc/animation-run.json`);
    expect(deepCanonicalizeImportedRunPaths(id, {
      runPath: `art-source/sprites/${id}/grok/walk-east-abc`,
      nested: ['grok/walk-south-def/generated/strip.png'],
      kind: 'grok-game-animation-frames-run',
    })).toEqual({
      runPath: `art-source/sprites/${id}/runs/walk-east-abc`,
      nested: ['runs/walk-south-def/generated/strip.png'],
      kind: 'grok-game-animation-frames-run',
    });
  });
});