synomem 0.1.0

package/dist/skill-install.js

@@ -0,0 +1,256 @@
+import { cpSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, renameSync, rmSync, symlinkSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SynomemError } from './errors.js';
+import { actorSchema } from './schemas.js';
+import { packageVersion } from './version.js';
+export const skillRuntimeNames = [
+    'codex',
+    'claude',
+    'hermes',
+    'openclaw',
+    'cursor',
+    'grok',
+];
+const stampName = '.synomem-install.json';
+function runtimeHomes(userHome, env) {
+    return {
+        codex: resolve(env.CODEX_HOME || join(userHome, '.codex')),
+        claude: resolve(env.CLAUDE_CONFIG_DIR || join(userHome, '.claude')),
+        hermes: resolve(env.HERMES_HOME || join(userHome, '.hermes')),
+        openclaw: resolve(env.OPENCLAW_STATE_DIR || join(userHome, '.openclaw')),
+        cursor: resolve(join(userHome, '.cursor')),
+        grok: resolve(env.GROK_HOME || join(userHome, '.grok')),
+    };
+}
+function selectedRuntimes(options) {
+    const defaults = [...skillRuntimeNames];
+    return [...new Set(options.runtimes?.length ? options.runtimes : defaults)];
+}
+function sourcePath(options) {
+    return resolve(options.source ?? fileURLToPath(new URL('../skills/synomem', import.meta.url)));
+}
+function assertSource(source) {
+    if (!existsSync(join(source, 'SKILL.md'))) {
+        throw new SynomemError('INTERNAL_ERROR', 'The packaged Synomem skill is missing.');
+    }
+}
+function readStamp(target) {
+    try {
+        const parsed = JSON.parse(readFileSync(join(target, stampName), 'utf8'));
+        if (parsed.package === 'synomem' &&
+            typeof parsed.version === 'string' &&
+            skillRuntimeNames.some((runtime) => runtime === parsed.runtime) &&
+            parsed.mode === 'copy') {
+            return parsed;
+        }
+    }
+    catch {
+        // Missing or invalid stamps are treated as unowned conflicts.
+    }
+    return undefined;
+}
+function entryExists(path) {
+    try {
+        lstatSync(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+function linkIsOurs(target, source) {
+    if (!entryExists(target) || !lstatSync(target).isSymbolicLink())
+        return false;
+    return resolve(dirname(target), readlinkSync(target)) === source;
+}
+function inspect(runtime, runtimeHome, source) {
+    const target = join(runtimeHome, 'skills', 'synomem');
+    if (!existsSync(runtimeHome))
+        return { runtime, runtimeHome, target, state: 'unavailable' };
+    const skillsHome = dirname(target);
+    if (lstatSync(runtimeHome).isSymbolicLink() ||
+        !lstatSync(runtimeHome).isDirectory() ||
+        (entryExists(skillsHome) &&
+            (lstatSync(skillsHome).isSymbolicLink() || !lstatSync(skillsHome).isDirectory()))) {
+        return { runtime, runtimeHome, target, state: 'conflict' };
+    }
+    if (!entryExists(target))
+        return { runtime, runtimeHome, target, state: 'missing' };
+    if (linkIsOurs(target, source)) {
+        return { runtime, runtimeHome, target, state: 'current', mode: 'link' };
+    }
+    if (lstatSync(target).isSymbolicLink() || !lstatSync(target).isDirectory()) {
+        return { runtime, runtimeHome, target, state: 'conflict' };
+    }
+    const stamp = readStamp(target);
+    if (!stamp || stamp.runtime !== runtime)
+        return { runtime, runtimeHome, target, state: 'conflict' };
+    return {
+        runtime,
+        runtimeHome,
+        target,
+        state: stamp.version === packageVersion() ? 'current' : 'stale',
+        installedVersion: stamp.version,
+        mode: 'copy',
+    };
+}
+function shellQuote(value) {
+    return `'${value.replaceAll("'", `'\\''`)}'`;
+}
+function mcpCommand(runtime, actorId, actorName) {
+    if (!actorId)
+        return undefined;
+    const identity = actorSchema.parse({
+        kind: 'agent',
+        id: actorId,
+        displayName: actorName ?? actorId,
+    });
+    const name = identity.displayName ?? identity.id;
+    const args = ['--actor-id', identity.id, '--actor-kind', 'agent', '--actor-name', name];
+    if (runtime === 'codex') {
+        return `codex mcp add synomem -- synomem-mcp ${args.map(shellQuote).join(' ')}`;
+    }
+    if (runtime === 'claude') {
+        return `claude mcp add --scope user synomem -- synomem-mcp ${args.map(shellQuote).join(' ')}`;
+    }
+    if (runtime === 'hermes') {
+        return `hermes mcp add synomem --command synomem-mcp --args ${args.map(shellQuote).join(' ')}`;
+    }
+    if (runtime === 'openclaw') {
+        return `openclaw mcp add synomem --command synomem-mcp ${args.map((item) => `--arg=${shellQuote(item)}`).join(' ')}`;
+    }
+    if (runtime === 'grok') {
+        return `grok mcp add synomem -- synomem-mcp ${args.map(shellQuote).join(' ')}`;
+    }
+    return undefined;
+}
+function assertSafeTarget(runtimeHome, target) {
+    if (target !== join(runtimeHome, 'skills', 'synomem')) {
+        throw new SynomemError('UNSAFE_PATH', 'Refusing an unexpected skill destination.');
+    }
+    const skillsHome = dirname(target);
+    if (!existsSync(runtimeHome) ||
+        lstatSync(runtimeHome).isSymbolicLink() ||
+        !lstatSync(runtimeHome).isDirectory() ||
+        (entryExists(skillsHome) &&
+            (lstatSync(skillsHome).isSymbolicLink() || !lstatSync(skillsHome).isDirectory()))) {
+        throw new SynomemError('UNSAFE_PATH', `Refusing an unsafe runtime skill path: ${runtimeHome}`);
+    }
+}
+function replaceTarget(location, source, runtime, link) {
+    const parent = dirname(location.target);
+    mkdirSync(parent, { recursive: true, mode: 0o700 });
+    const temporary = join(parent, `.synomem-${process.pid}-${Date.now()}.tmp`);
+    const backup = join(parent, `.synomem-${process.pid}-${Date.now()}.bak`);
+    try {
+        if (link) {
+            symlinkSync(source, temporary, process.platform === 'win32' ? 'junction' : 'dir');
+        }
+        else {
+            cpSync(source, temporary, { recursive: true, errorOnExist: true });
+            const stamp = {
+                package: 'synomem',
+                version: packageVersion(),
+                runtime,
+                mode: 'copy',
+            };
+            writeFileSync(join(temporary, stampName), `${JSON.stringify(stamp, null, 2)}\n`, {
+                encoding: 'utf8',
+                mode: 0o600,
+            });
+        }
+        if (entryExists(location.target))
+            renameSync(location.target, backup);
+        renameSync(temporary, location.target);
+        if (existsSync(backup))
+            rmSync(backup, { recursive: true, force: true });
+    }
+    catch (error) {
+        if (!entryExists(location.target) && entryExists(backup))
+            renameSync(backup, location.target);
+        throw error;
+    }
+    finally {
+        if (entryExists(temporary))
+            rmSync(temporary, { recursive: true, force: true });
+    }
+}
+export function skillStatus(options = {}) {
+    const userHome = resolve(options.userHome ?? homedir());
+    const source = sourcePath(options);
+    assertSource(source);
+    const homes = runtimeHomes(userHome, options.env ?? process.env);
+    const locations = selectedRuntimes(options).map((runtime) => inspect(runtime, homes[runtime], source));
+    return {
+        changed: false,
+        dryRun: true,
+        packageVersion: packageVersion(),
+        locations,
+        mcpCommands: locations
+            .map((location) => mcpCommand(location.runtime, options.actorId, options.actorName))
+            .filter((value) => Boolean(value)),
+    };
+}
+export function installSkill(options = {}) {
+    const result = skillStatus(options);
+    const source = sourcePath(options);
+    const desiredMode = options.link ? 'link' : 'copy';
+    for (const location of result.locations) {
+        if (location.state === 'unavailable' ||
+            (location.state === 'current' && location.mode === desiredMode)) {
+            continue;
+        }
+        if (location.state === 'conflict' && options.apply && !options.force) {
+            throw new SynomemError('INVALID_INPUT', `${location.target} already exists and is not owned by Synomem; use --force to replace it.`);
+        }
+        if (options.apply) {
+            assertSafeTarget(location.runtimeHome, location.target);
+            replaceTarget(location, source, location.runtime, Boolean(options.link));
+            result.changed = true;
+        }
+    }
+    result.dryRun = !options.apply;
+    if (!options.apply)
+        return result;
+    const updated = skillStatus({ ...options, apply: false });
+    return { ...updated, changed: result.changed, dryRun: false };
+}
+export function uninstallSkill(options = {}) {
+    const result = skillStatus(options);
+    for (const location of result.locations) {
+        if (location.state === 'missing' || location.state === 'unavailable')
+            continue;
+        if (location.state === 'conflict' && options.apply && !options.force) {
+            throw new SynomemError('INVALID_INPUT', `${location.target} is not owned by Synomem; refusing to remove it without --force.`);
+        }
+        if (options.apply) {
+            assertSafeTarget(location.runtimeHome, location.target);
+            rmSync(location.target, { recursive: true, force: false });
+            result.changed = true;
+        }
+    }
+    result.dryRun = !options.apply;
+    if (!options.apply)
+        return result;
+    const updated = skillStatus({ ...options, apply: false });
+    return { ...updated, changed: result.changed, dryRun: false };
+}
+export function formatSkillResult(result, operation) {
+    const lines = result.locations.map((location) => {
+        const version = location.installedVersion ? ` (version ${location.installedVersion})` : '';
+        return `${location.runtime.padEnd(6)} ${location.state.padEnd(11)} ${location.target}${version}`;
+    });
+    if (operation !== 'status' && result.dryRun)
+        lines.push('', 'Dry run only. Re-run with --yes to apply.');
+    if (result.mcpCommands.length)
+        lines.push('', 'MCP registration:', ...result.mcpCommands);
+    else if (operation === 'install') {
+        lines.push('', 'Tip: add --actor-id <agent-id> to print MCP registration commands.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=skill-install.js.map

package/dist/skill-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-install.js","sourceRoot":"","sources":["../src/skill-install.ts"],"names":[],"mappings":"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"}

package/dist/storage.d.ts

@@ -0,0 +1,94 @@
+import { DatabaseSync } from 'node:sqlite';
+import type { SynomemRepository } from './ports/repository.js';
+import { SynomemError } from './errors.js';
+import type { ActorIdentity, SynomemConfig, SynomemConfigOverrides, AgentProfile, ChangePage, SynomemEvent, ItemListInput, ItemSummary, RecordKind, KudosListInput, KudosSummary, Page } from './types.js';
+interface EventRow {
+    id: string;
+    payload: string;
+    sequence?: number;
+}
+export interface EventScan {
+    events: SynomemEvent[];
+    invalid: Array<{
+        id: string;
+        error: SynomemError;
+    }>;
+}
+export interface StorageOptions {
+    home: string;
+    readOnly: boolean;
+    config?: SynomemConfigOverrides;
+}
+export declare class SynomemStorage implements SynomemRepository {
+    readonly home: string;
+    readonly storageDirectory: string;
+    readonly databasePath: string;
+    readonly configPath: string;
+    readonly readOnly: boolean;
+    config: SynomemConfig;
+    private database?;
+    private readonly configOverrides?;
+    private validatedEventSequence;
+    private transactionTail;
+    constructor(options: StorageOptions);
+    init(): void;
+    private migrate;
+    private assertSchemaSupported;
+    db(): DatabaseSync;
+    assertWritable(): void;
+    transaction<T>(operation: () => T | Promise<T>): Promise<T>;
+    transactionSync<T>(operation: () => T): T;
+    insertEvent(event: SynomemEvent): void;
+    private applyEventToCurrent;
+    private applyEventToItems;
+    rebuildItemsCurrentIndex(): void;
+    rebuildKudosCurrentIndex(): void;
+    nextAggregateVersion(aggregateId: string): number;
+    listKudosSummaries(input: Required<Pick<KudosListInput, 'limit' | 'offset'>> & KudosListInput, viewer: ActorIdentity): Page<KudosSummary>;
+    listKudosChanges(after: string | undefined, limit: number, viewer: ActorIdentity): ChangePage;
+    listItemSummaries(input: Required<Pick<ItemListInput, 'limit' | 'offset'>> & ItemListInput, viewer: ActorIdentity): Page<ItemSummary>;
+    listItemChanges(after: string | undefined, limit: number, viewer: ActorIdentity, kinds?: RecordKind[]): ChangePage;
+    getItemSummary(id: string): ItemSummary | undefined;
+    getReadableItemEvents(id: string): SynomemEvent[];
+    currentIndexHealth(): {
+        given: number;
+        indexed: number;
+        stateMismatches: number;
+    };
+    itemIndexHealth(): {
+        created: number;
+        indexed: number;
+    };
+    migrationState(): {
+        schemaVersion: number;
+        appliedVersions: number[];
+    };
+    aliasIdentityConflicts(): Array<{
+        alias: string;
+        agentId: string;
+    }>;
+    private maxEventSequence;
+    getEvent(id: string): SynomemEvent | undefined;
+    getEventByIdempotency(actorKind: string, actorId: string, key: string): SynomemEvent | undefined;
+    getEvents(): SynomemEvent[];
+    getReadableEvents(): SynomemEvent[];
+    getReadableSynomemEvents(kudosId: string): SynomemEvent[];
+    scanEvents(): EventScan;
+    assertEventCompatibility(): void;
+    rawEventRows(): EventRow[];
+    private parseEvent;
+    insertAgent(profile: AgentProfile): void;
+    updateAgent(profile: AgentProfile, updatedAt: string): void;
+    getAgent(idOrAlias: string): AgentProfile | undefined;
+    listAgents(): AgentProfile[];
+    replaceProjectionManifest(paths: string[], generatedAt: string): void;
+    replaceAgentProjectionManifest(agentId: string, paths: string[], generatedAt: string): void;
+    projectionManifest(): string[];
+    integrityCheck(): string[];
+    journalMode(): string;
+    backup(destination: string): Promise<string>;
+    private restrictDatabaseFiles;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}