@myclaw163/clawclaw-cli 0.6.70 → 0.6.74

package/src/lib/hub-unzip.test.ts

@@ -1,69 +1,69 @@
-// src/lib/hub-unzip.test.ts
-import { describe, it, expect } from 'vitest';
-import { deflateRawSync } from 'zlib';
-import { unzip } from './hub-unzip.js';
-
-function u16(n: number): Buffer { const b = Buffer.alloc(2); b.writeUInt16LE(n); return b; }
-function u32(n: number): Buffer { const b = Buffer.alloc(4); b.writeUInt32LE(n >>> 0); return b; }
-
-// Independent minimal ZIP encoder (lays bytes by hand; does NOT use production code).
-function buildZip(files: Record<string, string>, opts: { deflate?: boolean } = {}): Buffer {
-  const deflate = !!opts.deflate;
-  const locals: Buffer[] = [];
-  const centrals: Buffer[] = [];
-  let offset = 0;
-  const names = Object.keys(files);
-  for (const name of names) {
-    const raw = Buffer.from(files[name], 'utf8');
-    const data = deflate && raw.length ? deflateRawSync(raw) : raw;
-    const method = deflate && raw.length ? 8 : 0;
-    const nameBuf = Buffer.from(name, 'utf8');
-    const local = Buffer.concat([
-      u32(0x04034b50), u16(20), u16(0), u16(method), u16(0), u16(0),
-      u32(0), u32(data.length), u32(raw.length), u16(nameBuf.length), u16(0),
-      nameBuf, data,
-    ]);
-    const central = Buffer.concat([
-      u32(0x02014b50), u16(20), u16(20), u16(0), u16(method), u16(0), u16(0),
-      u32(0), u32(data.length), u32(raw.length),
-      u16(nameBuf.length), u16(0), u16(0), u16(0), u16(0), u32(0), u32(offset),
-      nameBuf,
-    ]);
-    locals.push(local);
-    centrals.push(central);
-    offset += local.length;
-  }
-  const localPart = Buffer.concat(locals);
-  const cd = Buffer.concat(centrals);
-  const eocd = Buffer.concat([
-    u32(0x06054b50), u16(0), u16(0), u16(names.length), u16(names.length),
-    u32(cd.length), u32(localPart.length), u16(0),
-  ]);
-  return Buffer.concat([localPart, cd, eocd]);
-}
-
-describe('unzip', () => {
-  it('extracts stored (uncompressed) entries', () => {
-    const z = buildZip({ 'SKILL.md': '# hi', 'dir/sub.ts': 'export const x = 1;' });
-    const files = unzip(z);
-    const map = Object.fromEntries(files.map(f => [f.path, f.content.toString('utf8')]));
-    expect(map['SKILL.md']).toBe('# hi');
-    expect(map['dir/sub.ts']).toBe('export const x = 1;');
-  });
-
-  it('extracts deflated entries', () => {
-    const z = buildZip({ 'a.txt': 'hello hello hello world world world' }, { deflate: true });
-    const files = unzip(z);
-    expect(files[0].content.toString('utf8')).toBe('hello hello hello world world world');
-  });
-
-  it('skips directory entries', () => {
-    const z = buildZip({ 'dir/': '', 'dir/a.ts': 'A' });
-    const files = unzip(z);
-    expect(files.map(f => f.path)).toEqual(['dir/a.ts']);
-  });
-
-  it('throws on a non-zip buffer', () => {
-    expect(() => unzip(Buffer.alloc(40))).toThrow(/not a zip|EOCD/i);
-  });
-});
+// src/lib/hub-unzip.test.ts
+import { describe, it, expect } from 'vitest';
+import { deflateRawSync } from 'zlib';
+import { unzip } from './hub-unzip.js';
+
+function u16(n: number): Buffer { const b = Buffer.alloc(2); b.writeUInt16LE(n); return b; }
+function u32(n: number): Buffer { const b = Buffer.alloc(4); b.writeUInt32LE(n >>> 0); return b; }
+
+// Independent minimal ZIP encoder (lays bytes by hand; does NOT use production code).
+function buildZip(files: Record<string, string>, opts: { deflate?: boolean } = {}): Buffer {
+  const deflate = !!opts.deflate;
+  const locals: Buffer[] = [];
+  const centrals: Buffer[] = [];
+  let offset = 0;
+  const names = Object.keys(files);
+  for (const name of names) {
+    const raw = Buffer.from(files[name], 'utf8');
+    const data = deflate && raw.length ? deflateRawSync(raw) : raw;
+    const method = deflate && raw.length ? 8 : 0;
+    const nameBuf = Buffer.from(name, 'utf8');
+    const local = Buffer.concat([
+      u32(0x04034b50), u16(20), u16(0), u16(method), u16(0), u16(0),
+      u32(0), u32(data.length), u32(raw.length), u16(nameBuf.length), u16(0),
+      nameBuf, data,
+    ]);
+    const central = Buffer.concat([
+      u32(0x02014b50), u16(20), u16(20), u16(0), u16(method), u16(0), u16(0),
+      u32(0), u32(data.length), u32(raw.length),
+      u16(nameBuf.length), u16(0), u16(0), u16(0), u16(0), u32(0), u32(offset),
+      nameBuf,
+    ]);
+    locals.push(local);
+    centrals.push(central);
+    offset += local.length;
+  }
+  const localPart = Buffer.concat(locals);
+  const cd = Buffer.concat(centrals);
+  const eocd = Buffer.concat([
+    u32(0x06054b50), u16(0), u16(0), u16(names.length), u16(names.length),
+    u32(cd.length), u32(localPart.length), u16(0),
+  ]);
+  return Buffer.concat([localPart, cd, eocd]);
+}
+
+describe('unzip', () => {
+  it('extracts stored (uncompressed) entries', () => {
+    const z = buildZip({ 'SKILL.md': '# hi', 'dir/sub.ts': 'export const x = 1;' });
+    const files = unzip(z);
+    const map = Object.fromEntries(files.map(f => [f.path, f.content.toString('utf8')]));
+    expect(map['SKILL.md']).toBe('# hi');
+    expect(map['dir/sub.ts']).toBe('export const x = 1;');
+  });
+
+  it('extracts deflated entries', () => {
+    const z = buildZip({ 'a.txt': 'hello hello hello world world world' }, { deflate: true });
+    const files = unzip(z);
+    expect(files[0].content.toString('utf8')).toBe('hello hello hello world world world');
+  });
+
+  it('skips directory entries', () => {
+    const z = buildZip({ 'dir/': '', 'dir/a.ts': 'A' });
+    const files = unzip(z);
+    expect(files.map(f => f.path)).toEqual(['dir/a.ts']);
+  });
+
+  it('throws on a non-zip buffer', () => {
+    expect(() => unzip(Buffer.alloc(40))).toThrow(/not a zip|EOCD/i);
+  });
+});

package/src/lib/hub-unzip.ts

@@ -1,62 +1,62 @@
-// src/lib/hub-unzip.ts
-// Minimal dependency-free ZIP reader: supports store (method 0) and deflate (method 8),
-// enough for skill packages produced by Python's stdlib zipfile. No zip64/encryption.
-import { inflateRawSync } from 'zlib';
-
-export interface UnzippedFile { path: string; content: Buffer; }
-
-const EOCD_SIG = 0x06054b50;
-const CEN_SIG = 0x02014b50;
-const LOC_SIG = 0x04034b50;
-
-function findEocd(buf: Buffer): number {
-  const minPos = Math.max(0, buf.length - 22 - 0xffff);
-  for (let i = buf.length - 22; i >= minPos; i--) {
-    if (buf.readUInt32LE(i) === EOCD_SIG) {
-      const commentLen = buf.readUInt16LE(i + 20);
-      if (i + 22 + commentLen === buf.length) return i;
-    }
-  }
-  throw new Error('not a zip file (EOCD not found)');
-}
-
-export function unzip(buf: Buffer): UnzippedFile[] {
-  if (buf.length < 22) throw new Error('not a zip file (too small)');
-  const eocd = findEocd(buf);
-  const total = buf.readUInt16LE(eocd + 10);
-  const cdSize = buf.readUInt32LE(eocd + 12);
-  const cdOffset = buf.readUInt32LE(eocd + 16);
-  if (cdOffset + cdSize > buf.length) throw new Error('corrupt zip (central directory out of range)');
-
-  const files: UnzippedFile[] = [];
-  let p = cdOffset;
-  for (let n = 0; n < total; n++) {
-    if (p + 46 > cdOffset + cdSize) throw new Error('corrupt zip (central directory truncated)');
-    if (buf.readUInt32LE(p) !== CEN_SIG) throw new Error('corrupt zip (bad central directory header)');
-    const method = buf.readUInt16LE(p + 10);
-    const compSize = buf.readUInt32LE(p + 20);
-    const nameLen = buf.readUInt16LE(p + 28);
-    const extraLen = buf.readUInt16LE(p + 30);
-    const commentLen = buf.readUInt16LE(p + 32);
-    const localOffset = buf.readUInt32LE(p + 42);
-    const name = buf.toString('utf8', p + 46, p + 46 + nameLen);
-    p += 46 + nameLen + extraLen + commentLen;
-
-    if (name.endsWith('/')) continue; // directory entry
-
-    if (buf.readUInt32LE(localOffset) !== LOC_SIG) throw new Error(`corrupt zip (bad local header for ${name})`);
-    const locNameLen = buf.readUInt16LE(localOffset + 26);
-    const locExtraLen = buf.readUInt16LE(localOffset + 28);
-    const dataStart = localOffset + 30 + locNameLen + locExtraLen;
-    if (dataStart + compSize > buf.length) throw new Error(`corrupt zip (data out of range for ${name})`);
-    const data = buf.subarray(dataStart, dataStart + compSize);
-
-    let content: Buffer;
-    if (method === 0) content = Buffer.from(data);
-    else if (method === 8) content = inflateRawSync(data);
-    else throw new Error(`unsupported zip compression method ${method} for ${name}`);
-
-    files.push({ path: name.split('\\').join('/'), content });
-  }
-  return files;
-}
+// src/lib/hub-unzip.ts
+// Minimal dependency-free ZIP reader: supports store (method 0) and deflate (method 8),
+// enough for skill packages produced by Python's stdlib zipfile. No zip64/encryption.
+import { inflateRawSync } from 'zlib';
+
+export interface UnzippedFile { path: string; content: Buffer; }
+
+const EOCD_SIG = 0x06054b50;
+const CEN_SIG = 0x02014b50;
+const LOC_SIG = 0x04034b50;
+
+function findEocd(buf: Buffer): number {
+  const minPos = Math.max(0, buf.length - 22 - 0xffff);
+  for (let i = buf.length - 22; i >= minPos; i--) {
+    if (buf.readUInt32LE(i) === EOCD_SIG) {
+      const commentLen = buf.readUInt16LE(i + 20);
+      if (i + 22 + commentLen === buf.length) return i;
+    }
+  }
+  throw new Error('not a zip file (EOCD not found)');
+}
+
+export function unzip(buf: Buffer): UnzippedFile[] {
+  if (buf.length < 22) throw new Error('not a zip file (too small)');
+  const eocd = findEocd(buf);
+  const total = buf.readUInt16LE(eocd + 10);
+  const cdSize = buf.readUInt32LE(eocd + 12);
+  const cdOffset = buf.readUInt32LE(eocd + 16);
+  if (cdOffset + cdSize > buf.length) throw new Error('corrupt zip (central directory out of range)');
+
+  const files: UnzippedFile[] = [];
+  let p = cdOffset;
+  for (let n = 0; n < total; n++) {
+    if (p + 46 > cdOffset + cdSize) throw new Error('corrupt zip (central directory truncated)');
+    if (buf.readUInt32LE(p) !== CEN_SIG) throw new Error('corrupt zip (bad central directory header)');
+    const method = buf.readUInt16LE(p + 10);
+    const compSize = buf.readUInt32LE(p + 20);
+    const nameLen = buf.readUInt16LE(p + 28);
+    const extraLen = buf.readUInt16LE(p + 30);
+    const commentLen = buf.readUInt16LE(p + 32);
+    const localOffset = buf.readUInt32LE(p + 42);
+    const name = buf.toString('utf8', p + 46, p + 46 + nameLen);
+    p += 46 + nameLen + extraLen + commentLen;
+
+    if (name.endsWith('/')) continue; // directory entry
+
+    if (buf.readUInt32LE(localOffset) !== LOC_SIG) throw new Error(`corrupt zip (bad local header for ${name})`);
+    const locNameLen = buf.readUInt16LE(localOffset + 26);
+    const locExtraLen = buf.readUInt16LE(localOffset + 28);
+    const dataStart = localOffset + 30 + locNameLen + locExtraLen;
+    if (dataStart + compSize > buf.length) throw new Error(`corrupt zip (data out of range for ${name})`);
+    const data = buf.subarray(dataStart, dataStart + compSize);
+
+    let content: Buffer;
+    if (method === 0) content = Buffer.from(data);
+    else if (method === 8) content = inflateRawSync(data);
+    else throw new Error(`unsupported zip compression method ${method} for ${name}`);
+
+    files.push({ path: name.split('\\').join('/'), content });
+  }
+  return files;
+}

package/src/lib/init-command.test.ts

@@ -1,75 +1,75 @@
-import { describe, expect, it } from 'vitest';
-import { join, resolve } from 'path';
-import { CLAWCLAW_WORKSPACE_DIR, resolveWorkspaceDir } from './init-command.js';
-
-describe('resolveWorkspaceDir', () => {
-  it('uses an absolute env override as-is', () => {
-    expect(
-      resolveWorkspaceDir({
-        env: { [CLAWCLAW_WORKSPACE_DIR]: 'D:\\workspaces\\clawclaw' },
-        platform: 'win32',
-        homeDir: 'C:\\Users\\test',
-        cwd: 'C:\\repo',
-      }),
-    ).toBe('D:\\workspaces\\clawclaw');
-  });
-
-  it('resolves a relative env override against cwd', () => {
-    const cwd = 'C:\\repo\\project';
-    expect(
-      resolveWorkspaceDir({
-        env: { [CLAWCLAW_WORKSPACE_DIR]: 'tmp/clawclaw-workspace' },
-        platform: 'linux',
-        homeDir: '/home/test',
-        cwd,
-      }),
-    ).toBe(resolve(cwd, 'tmp/clawclaw-workspace'));
-  });
-
-  it('ignores a blank env override', () => {
-    expect(
-      resolveWorkspaceDir({
-        env: {
-          [CLAWCLAW_WORKSPACE_DIR]: '   ',
-          APPDATA: 'C:\\Users\\test\\AppData\\Roaming',
-        },
-        platform: 'win32',
-        homeDir: 'C:\\Users\\test',
-        cwd: 'C:\\repo',
-      }),
-    ).toBe('C:\\Users\\test\\AppData\\Roaming\\clawclaw');
-  });
-
-  it('uses APPDATA on win32 when override is not set', () => {
-    expect(
-      resolveWorkspaceDir({
-        env: { APPDATA: 'D:\\AppData' },
-        platform: 'win32',
-        homeDir: 'C:\\Users\\test',
-        cwd: 'C:\\repo',
-      }),
-    ).toBe('D:\\AppData\\clawclaw');
-  });
-
-  it('falls back to home/AppData/Roaming on win32 when APPDATA is missing', () => {
-    expect(
-      resolveWorkspaceDir({
-        env: {},
-        platform: 'win32',
-        homeDir: 'C:\\Users\\test',
-        cwd: 'C:\\repo',
-      }),
-    ).toBe('C:\\Users\\test\\AppData\\Roaming\\clawclaw');
-  });
-
-  it('uses the non-win32 default path when override is not set', () => {
-    expect(
-      resolveWorkspaceDir({
-        env: {},
-        platform: 'linux',
-        homeDir: '/home/test',
-        cwd: '/repo/project',
-      }),
-    ).toBe(join('/home/test', '.clawclaw'));
-  });
-});
+import { describe, expect, it } from 'vitest';
+import { join, resolve } from 'path';
+import { CLAWCLAW_WORKSPACE_DIR, resolveWorkspaceDir } from './init-command.js';
+
+describe('resolveWorkspaceDir', () => {
+  it('uses an absolute env override as-is', () => {
+    expect(
+      resolveWorkspaceDir({
+        env: { [CLAWCLAW_WORKSPACE_DIR]: 'D:\\workspaces\\clawclaw' },
+        platform: 'win32',
+        homeDir: 'C:\\Users\\test',
+        cwd: 'C:\\repo',
+      }),
+    ).toBe('D:\\workspaces\\clawclaw');
+  });
+
+  it('resolves a relative env override against cwd', () => {
+    const cwd = 'C:\\repo\\project';
+    expect(
+      resolveWorkspaceDir({
+        env: { [CLAWCLAW_WORKSPACE_DIR]: 'tmp/clawclaw-workspace' },
+        platform: 'linux',
+        homeDir: '/home/test',
+        cwd,
+      }),
+    ).toBe(resolve(cwd, 'tmp/clawclaw-workspace'));
+  });
+
+  it('ignores a blank env override', () => {
+    expect(
+      resolveWorkspaceDir({
+        env: {
+          [CLAWCLAW_WORKSPACE_DIR]: '   ',
+          APPDATA: 'C:\\Users\\test\\AppData\\Roaming',
+        },
+        platform: 'win32',
+        homeDir: 'C:\\Users\\test',
+        cwd: 'C:\\repo',
+      }),
+    ).toBe('C:\\Users\\test\\AppData\\Roaming\\clawclaw');
+  });
+
+  it('uses APPDATA on win32 when override is not set', () => {
+    expect(
+      resolveWorkspaceDir({
+        env: { APPDATA: 'D:\\AppData' },
+        platform: 'win32',
+        homeDir: 'C:\\Users\\test',
+        cwd: 'C:\\repo',
+      }),
+    ).toBe('D:\\AppData\\clawclaw');
+  });
+
+  it('falls back to home/AppData/Roaming on win32 when APPDATA is missing', () => {
+    expect(
+      resolveWorkspaceDir({
+        env: {},
+        platform: 'win32',
+        homeDir: 'C:\\Users\\test',
+        cwd: 'C:\\repo',
+      }),
+    ).toBe('C:\\Users\\test\\AppData\\Roaming\\clawclaw');
+  });
+
+  it('uses the non-win32 default path when override is not set', () => {
+    expect(
+      resolveWorkspaceDir({
+        env: {},
+        platform: 'linux',
+        homeDir: '/home/test',
+        cwd: '/repo/project',
+      }),
+    ).toBe(join('/home/test', '.clawclaw'));
+  });
+});

package/src/lib/init-command.ts

@@ -1,120 +1,120 @@
-import { existsSync, mkdirSync, writeFileSync } from 'fs';
-import { isAbsolute, join, resolve, win32 } from 'path';
-import { homedir } from 'os';
-import type { AuthProfile } from './auth.js';
-
-const ACCOUNT_DIRS = ['state', 'logs', 'games'];
-
-export const CLAWCLAW_WORKSPACE_DIR = 'CLAWCLAW_WORKSPACE_DIR';
-
-export type ResolveWorkspaceDirOptions = {
-  env?: Record<string, string | undefined>;
-  platform?: NodeJS.Platform;
-  homeDir?: string;
-  cwd?: string;
-};
-
-export function resolveWorkspaceDir({
-  env = process.env,
-  platform = process.platform,
-  homeDir = homedir(),
-  cwd = process.cwd(),
-}: ResolveWorkspaceDirOptions = {}): string {
-  const rawWorkspaceDir = env[CLAWCLAW_WORKSPACE_DIR];
-  const pathApi = platform === 'win32' ? win32 : { isAbsolute, join, resolve };
-  if (typeof rawWorkspaceDir === 'string') {
-    const trimmedWorkspaceDir = rawWorkspaceDir.trim();
-    if (trimmedWorkspaceDir !== '') {
-      return pathApi.isAbsolute(trimmedWorkspaceDir)
-        ? trimmedWorkspaceDir
-        : pathApi.resolve(cwd, trimmedWorkspaceDir);
-    }
-  }
-
-  if (platform === 'win32') {
-    const appData = env.APPDATA ?? win32.join(homeDir, 'AppData', 'Roaming');
-    return win32.join(appData, 'clawclaw');
-  }
-  return join(homeDir, '.clawclaw');
-}
-
-export function getWorkspaceDir(): string {
-  return resolveWorkspaceDir();
-}
-
-export function cmdInit(force = false): { created: boolean; path: string } {
-  const workspaceDir = getWorkspaceDir();
-  const alreadyExists = existsSync(join(workspaceDir, 'config.json'));
-
-  if (alreadyExists && !force) {
-    return { created: false, path: workspaceDir };
-  }
-
-  mkdirSync(workspaceDir, { recursive: true });
-  mkdirSync(join(workspaceDir, 'accounts'), { recursive: true });
-
-  if (!alreadyExists) {
-    writeFileSync(
-      join(workspaceDir, 'config.json'),
-      JSON.stringify({}, null, 2),
-    );
-  }
-
-  return { created: !alreadyExists, path: workspaceDir };
-}
-
-export function getAccountDir(accountId: string): string {
-  return join(getWorkspaceDir(), 'accounts', accountId);
-}
-
-export function createAccountDirs(accountId: string): void {
-  const accountDir = getAccountDir(accountId);
-  for (const sub of ACCOUNT_DIRS) {
-    mkdirSync(join(accountDir, sub), { recursive: true });
-  }
-}
-
-export function getAccountId(profile: Pick<AuthProfile, 'apiKey'>): string {
-  return profile.apiKey;
-}
-
-export function createProfileDirs(profile: Pick<AuthProfile, 'apiKey'>): void {
-  createAccountDirs(getAccountId(profile));
-}
-
-export function getStateDir(accountId: string): string {
-  return join(getAccountDir(accountId), 'state');
-}
-
-export function getLogsDir(accountId: string): string {
-  return join(getAccountDir(accountId), 'logs');
-}
-
-export function getGamesDir(accountId: string): string {
-  return join(getAccountDir(accountId), 'games');
-}
-
-export function getProfileStateDir(profile: Pick<AuthProfile, 'apiKey'>): string {
-  createProfileDirs(profile);
-  return getStateDir(getAccountId(profile));
-}
-
-export function getProfileLogsDir(profile: Pick<AuthProfile, 'apiKey'>): string {
-  createProfileDirs(profile);
-  return getLogsDir(getAccountId(profile));
-}
-
-export function getProfileGamesDir(profile: Pick<AuthProfile, 'apiKey'>): string {
-  createProfileDirs(profile);
-  return getGamesDir(getAccountId(profile));
-}
-
-export function getProfileMemoryFile(profile: Pick<AuthProfile, 'apiKey'>): string {
-  createProfileDirs(profile);
-  return join(getAccountDir(getAccountId(profile)), 'memory.md');
-}
-
-export function getProfilePersonaFile(profile: Pick<AuthProfile, 'apiKey'>): string {
-  createProfileDirs(profile);
-  return join(getAccountDir(getAccountId(profile)), 'persona.md');
-}
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { isAbsolute, join, resolve, win32 } from 'path';
+import { homedir } from 'os';
+import type { AuthProfile } from './auth.js';
+
+const ACCOUNT_DIRS = ['state', 'logs', 'games'];
+
+export const CLAWCLAW_WORKSPACE_DIR = 'CLAWCLAW_WORKSPACE_DIR';
+
+export type ResolveWorkspaceDirOptions = {
+  env?: Record<string, string | undefined>;
+  platform?: NodeJS.Platform;
+  homeDir?: string;
+  cwd?: string;
+};
+
+export function resolveWorkspaceDir({
+  env = process.env,
+  platform = process.platform,
+  homeDir = homedir(),
+  cwd = process.cwd(),
+}: ResolveWorkspaceDirOptions = {}): string {
+  const rawWorkspaceDir = env[CLAWCLAW_WORKSPACE_DIR];
+  const pathApi = platform === 'win32' ? win32 : { isAbsolute, join, resolve };
+  if (typeof rawWorkspaceDir === 'string') {
+    const trimmedWorkspaceDir = rawWorkspaceDir.trim();
+    if (trimmedWorkspaceDir !== '') {
+      return pathApi.isAbsolute(trimmedWorkspaceDir)
+        ? trimmedWorkspaceDir
+        : pathApi.resolve(cwd, trimmedWorkspaceDir);
+    }
+  }
+
+  if (platform === 'win32') {
+    const appData = env.APPDATA ?? win32.join(homeDir, 'AppData', 'Roaming');
+    return win32.join(appData, 'clawclaw');
+  }
+  return join(homeDir, '.clawclaw');
+}
+
+export function getWorkspaceDir(): string {
+  return resolveWorkspaceDir();
+}
+
+export function cmdInit(force = false): { created: boolean; path: string } {
+  const workspaceDir = getWorkspaceDir();
+  const alreadyExists = existsSync(join(workspaceDir, 'config.json'));
+
+  if (alreadyExists && !force) {
+    return { created: false, path: workspaceDir };
+  }
+
+  mkdirSync(workspaceDir, { recursive: true });
+  mkdirSync(join(workspaceDir, 'accounts'), { recursive: true });
+
+  if (!alreadyExists) {
+    writeFileSync(
+      join(workspaceDir, 'config.json'),
+      JSON.stringify({}, null, 2),
+    );
+  }
+
+  return { created: !alreadyExists, path: workspaceDir };
+}
+
+export function getAccountDir(accountId: string): string {
+  return join(getWorkspaceDir(), 'accounts', accountId);
+}
+
+export function createAccountDirs(accountId: string): void {
+  const accountDir = getAccountDir(accountId);
+  for (const sub of ACCOUNT_DIRS) {
+    mkdirSync(join(accountDir, sub), { recursive: true });
+  }
+}
+
+export function getAccountId(profile: Pick<AuthProfile, 'apiKey'>): string {
+  return profile.apiKey;
+}
+
+export function createProfileDirs(profile: Pick<AuthProfile, 'apiKey'>): void {
+  createAccountDirs(getAccountId(profile));
+}
+
+export function getStateDir(accountId: string): string {
+  return join(getAccountDir(accountId), 'state');
+}
+
+export function getLogsDir(accountId: string): string {
+  return join(getAccountDir(accountId), 'logs');
+}
+
+export function getGamesDir(accountId: string): string {
+  return join(getAccountDir(accountId), 'games');
+}
+
+export function getProfileStateDir(profile: Pick<AuthProfile, 'apiKey'>): string {
+  createProfileDirs(profile);
+  return getStateDir(getAccountId(profile));
+}
+
+export function getProfileLogsDir(profile: Pick<AuthProfile, 'apiKey'>): string {
+  createProfileDirs(profile);
+  return getLogsDir(getAccountId(profile));
+}
+
+export function getProfileGamesDir(profile: Pick<AuthProfile, 'apiKey'>): string {
+  createProfileDirs(profile);
+  return getGamesDir(getAccountId(profile));
+}
+
+export function getProfileMemoryFile(profile: Pick<AuthProfile, 'apiKey'>): string {
+  createProfileDirs(profile);
+  return join(getAccountDir(getAccountId(profile)), 'memory.md');
+}
+
+export function getProfilePersonaFile(profile: Pick<AuthProfile, 'apiKey'>): string {
+  createProfileDirs(profile);
+  return join(getAccountDir(getAccountId(profile)), 'persona.md');
+}