@m2-ai/lattice-cli 0.0.0-stage → 0.8.7

package/dist/delivered-project-files.test.js

@@ -0,0 +1,107 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_test_1 = __importDefault(require("node:test"));
+const delivered_project_files_js_1 = require("./delivered-project-files.js");
+async function withFixture(prefix, run) {
+    const root = await node_fs_1.promises.mkdtemp((0, node_path_1.join)((0, node_os_1.tmpdir)(), prefix));
+    const project = (0, node_path_1.join)(root, 'project');
+    await node_fs_1.promises.mkdir(project);
+    try {
+        await run({ root, project });
+    }
+    finally {
+        await node_fs_1.promises.rm(root, { recursive: true, force: true });
+    }
+}
+(0, node_test_1.default)('validates the complete delivered map before writing any file', async () => {
+    await withFixture('lattice-delivered-invalid-', async ({ project }) => {
+        await strict_1.default.rejects((0, delivered_project_files_js_1.writeDeliveredProjectFiles)(project, {
+            'valid/first.txt': 'must not be written',
+            '../outside.txt': 'must not escape',
+        }), /unsafe segment|escapes/);
+        await strict_1.default.rejects(node_fs_1.promises.access((0, node_path_1.join)(project, 'valid', 'first.txt')), { code: 'ENOENT' });
+    });
+});
+(0, node_test_1.default)('rejects parent, Windows, absolute, dot, empty, and NUL paths', async () => {
+    await withFixture('lattice-delivered-paths-', async ({ project }) => {
+        const invalidPaths = [
+            '../outside.txt',
+            'nested/../../outside.txt',
+            '..\\outside.txt',
+            'nested\\outside.txt',
+            'C:\\outside.txt',
+            'C:/outside.txt',
+            '\\\\server\\share\\outside.txt',
+            '/absolute.txt',
+            '.',
+            './inside.txt',
+            'nested/./inside.txt',
+            'nested//inside.txt',
+            '',
+            `nested/nul\0byte.txt`,
+        ];
+        for (const filePath of invalidPaths) {
+            await strict_1.default.rejects((0, delivered_project_files_js_1.prepareDeliveredProjectFiles)(project, { [filePath]: 'content' }), Error, `expected rejection for ${JSON.stringify(filePath)}`);
+        }
+    });
+});
+(0, node_test_1.default)('rejects an existing symbolic-link or junction component before writing', async () => {
+    await withFixture('lattice-delivered-link-', async ({ root, project }) => {
+        const outside = (0, node_path_1.join)(root, 'outside');
+        const linked = (0, node_path_1.join)(project, 'linked');
+        await node_fs_1.promises.mkdir(outside);
+        await node_fs_1.promises.symlink(outside, linked, process.platform === 'win32' ? 'junction' : 'dir');
+        await strict_1.default.rejects((0, delivered_project_files_js_1.writeDeliveredProjectFiles)(project, {
+            'safe.txt': 'must not be written',
+            'linked/escaped.txt': 'must not escape',
+        }), /symbolic link or junction/);
+        await strict_1.default.rejects(node_fs_1.promises.access((0, node_path_1.join)(project, 'safe.txt')), { code: 'ENOENT' });
+        await strict_1.default.rejects(node_fs_1.promises.access((0, node_path_1.join)(outside, 'escaped.txt')), { code: 'ENOENT' });
+    });
+});
+(0, node_test_1.default)('writes legitimate nested delivered files below the resolved project root', async () => {
+    await withFixture('lattice-delivered-valid-', async ({ project }) => {
+        const written = await (0, delivered_project_files_js_1.writeDeliveredProjectFiles)(project, {
+            'app/api/health/route.ts': 'export const healthy = true;\n',
+            '.github/workflows/ci.yml': 'name: CI\n',
+            'README.md': '# Fixture\n',
+        });
+        strict_1.default.deepEqual(written, [
+            'app/api/health/route.ts',
+            '.github/workflows/ci.yml',
+            'README.md',
+        ]);
+        strict_1.default.equal(await node_fs_1.promises.readFile((0, node_path_1.join)(project, 'app', 'api', 'health', 'route.ts'), 'utf8'), 'export const healthy = true;\n');
+        strict_1.default.equal(await node_fs_1.promises.readFile((0, node_path_1.join)(project, '.github', 'workflows', 'ci.yml'), 'utf8'), 'name: CI\n');
+        strict_1.default.equal(await node_fs_1.promises.readFile((0, node_path_1.join)(project, 'README.md'), 'utf8'), '# Fixture\n');
+    });
+});
+(0, node_test_1.default)('creates a missing selected root and writes below its canonical parent', async () => {
+    const root = await node_fs_1.promises.mkdtemp((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'lattice-delivered-missing-'));
+    const project = (0, node_path_1.join)(root, 'missing', 'project');
+    try {
+        await (0, delivered_project_files_js_1.writeDeliveredProjectFiles)(project, { 'nested/file.txt': 'content' });
+        strict_1.default.equal(await node_fs_1.promises.readFile((0, node_path_1.join)(project, 'nested', 'file.txt'), 'utf8'), 'content');
+    }
+    finally {
+        await node_fs_1.promises.rm(root, { recursive: true, force: true });
+    }
+});
+(0, node_test_1.default)('rejects overwriting a multiply-linked final file', async () => {
+    await withFixture('lattice-delivered-hardlink-', async ({ root, project }) => {
+        const outside = (0, node_path_1.join)(root, 'outside.txt');
+        const linked = (0, node_path_1.join)(project, 'linked.txt');
+        await node_fs_1.promises.writeFile(outside, 'outside sentinel');
+        await node_fs_1.promises.link(outside, linked);
+        await strict_1.default.rejects((0, delivered_project_files_js_1.writeDeliveredProjectFiles)(project, { 'linked.txt': 'replacement' }), /multiple hard links/);
+        strict_1.default.equal(await node_fs_1.promises.readFile(outside, 'utf8'), 'outside sentinel');
+    });
+});
+//# sourceMappingURL=delivered-project-files.test.js.map

package/dist/delivered-project-files.test.js.map

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

package/dist/doctor-agents.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=doctor-agents.test.d.ts.map

package/dist/doctor-agents.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-agents.test.d.ts","sourceRoot":"","sources":["../src/doctor-agents.test.ts"],"names":[],"mappings":""}

package/dist/doctor-agents.test.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const fs_2 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const node_test_1 = __importDefault(require("node:test"));
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_child_process_1 = require("node:child_process");
+const index_1 = require("./index");
+const originalLog = console.log;
+const originalError = console.error;
+function suppressConsole() {
+    console.log = () => { };
+    console.error = () => { };
+}
+function restoreConsole() {
+    console.log = originalLog;
+    console.error = originalError;
+}
+function createTempRepo() {
+    const dir = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), 'lattice-doctor-agents-'));
+    (0, node_child_process_1.execFileSync)('git', ['init'], { cwd: dir, stdio: 'ignore' });
+    (0, fs_1.mkdirSync)((0, path_1.join)(dir, '.lattice'), { recursive: true });
+    (0, fs_1.writeFileSync)((0, path_1.join)(dir, '.lattice', 'config.json'), JSON.stringify({
+        projectType: 'nextjs',
+        strictnessPreset: 'startup',
+    }, null, 2));
+    return dir;
+}
+async function withTempRepo(fn) {
+    const dir = createTempRepo();
+    const previousCwd = process.cwd();
+    suppressConsole();
+    process.chdir(dir);
+    try {
+        await fn(dir);
+    }
+    finally {
+        process.chdir(previousCwd);
+        restoreConsole();
+        (0, fs_1.rmSync)(dir, { recursive: true, force: true });
+    }
+}
+(0, node_test_1.default)('doctor --agents passes on a freshly generated repo', async () => {
+    await withTempRepo(async () => {
+        await (0, index_1.generate)('.lattice/pack');
+        await (0, index_1.apply)('.lattice/pack', '.');
+        const ok = await (0, index_1.doctor)({ exitOnFailure: false, agents: true });
+        strict_1.default.equal(ok, true);
+    });
+});
+(0, node_test_1.default)('doctor --agents fails when a required agent surface is missing', async () => {
+    await withTempRepo(async () => {
+        await (0, index_1.generate)('.lattice/pack');
+        await (0, index_1.apply)('.lattice/pack', '.');
+        await fs_2.promises.unlink((0, path_1.join)(process.cwd(), '.github', 'copilot-instructions.md'));
+        const ok = await (0, index_1.doctor)({ exitOnFailure: false, agents: true });
+        strict_1.default.equal(ok, false);
+    });
+});
+//# sourceMappingURL=doctor-agents.test.js.map

package/dist/doctor-agents.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-agents.test.js","sourceRoot":"","sources":["../src/doctor-agents.test.ts"],"names":[],"mappings":";;;;;AAAA,2BAAmE;AACnE,2BAAoC;AACpC,2BAA4B;AAC5B,+BAA4B;AAC5B,0DAA6B;AAC7B,gEAAwC;AACxC,2DAAkD;AAClD,mCAAkD;AAElD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;AAChC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;AAEpC,SAAS,eAAe;IACtB,OAAO,CAAC,GAAG,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,CAAC,GAAG,GAAG,WAAW,CAAC;IAC1B,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC;AAChC,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,IAAA,gBAAW,EAAC,IAAA,WAAI,EAAC,IAAA,WAAM,GAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAClE,IAAA,iCAAY,EAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7D,IAAA,cAAS,EAAC,IAAA,WAAI,EAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,IAAA,kBAAa,EACX,IAAA,WAAI,EAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,EACpC,IAAI,CAAC,SAAS,CACZ;QACE,WAAW,EAAE,QAAQ;QACrB,gBAAgB,EAAE,SAAS;KAC5B,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,EAAkC;IAC5D,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAElC,eAAe,EAAE,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEnB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC3B,cAAc,EAAE,CAAC;QACjB,IAAA,WAAM,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,IAAA,mBAAI,EAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;IACpE,MAAM,YAAY,CAAC,KAAK,IAAI,EAAE;QAC5B,MAAM,IAAA,gBAAQ,EAAC,eAAe,CAAC,CAAC;QAChC,MAAM,IAAA,aAAK,EAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QAElC,MAAM,EAAE,GAAG,MAAM,IAAA,cAAM,EAAC,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,gBAAM,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,mBAAI,EAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;IAChF,MAAM,YAAY,CAAC,KAAK,IAAI,EAAE;QAC5B,MAAM,IAAA,gBAAQ,EAAC,eAAe,CAAC,CAAC;QAChC,MAAM,IAAA,aAAK,EAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,aAAE,CAAC,MAAM,CAAC,IAAA,WAAI,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC,CAAC;QAE3E,MAAM,EAAE,GAAG,MAAM,IAAA,cAAM,EAAC,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,gBAAM,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/hermes-install.d.ts

@@ -0,0 +1,102 @@
+export type HermesProviderSetup = 'portal' | 'byok' | 'local' | 'during_setup';
+export type HermesTerminalBackend = 'local' | 'docker' | 'ssh' | 'during_setup';
+export interface RuntimeReleasePin {
+    tag: string;
+    packageVersion: string | null;
+    commitSha: string;
+    publishedAt: string;
+    reviewedAt: string;
+    installScriptSha256: {
+        windows: string;
+        posix: string;
+    };
+}
+export interface HermesInstallPayloadV2 {
+    productType: 'agent_setup';
+    runtime: 'hermes';
+    release: RuntimeReleasePin;
+    profileName: string;
+    distributionFiles: Record<string, string>;
+    localSeedFiles: {
+        'memories/USER.md'?: string;
+        'memories/MEMORY.md'?: string;
+    };
+    selectedChannels: string[];
+    providerSetup: HermesProviderSetup;
+    terminalBackend: HermesTerminalBackend;
+    requestedGatewaySetup: boolean;
+}
+export interface HermesInstallManifestV2 {
+    schemaVersion: 2;
+    project: {
+        id: string;
+        shortId: string | null;
+        name: string;
+        createdAt: string;
+    };
+    install: HermesInstallPayloadV2;
+}
+export interface HermesInstallOptions {
+    profileName?: string;
+    hermesHome?: string;
+    hermesCommand?: string;
+    skipHermesInstall?: boolean;
+    skipSetup?: boolean;
+    skipModelCheck?: boolean;
+    skipGatewaySetup?: boolean;
+    updateExistingProfile?: boolean;
+    dryRun?: boolean;
+}
+export interface HermesInstallerRuntime {
+    platform: NodeJS.Platform;
+    arch: string;
+    homeDir: string;
+    localAppData?: string;
+    tempDir: string;
+    now(): Date;
+    log(message: string): void;
+    download(url: string): Promise<Buffer>;
+    run(command: string, args: string[], options?: {
+        quiet?: boolean;
+        env?: NodeJS.ProcessEnv;
+        timeoutMs?: number;
+        unsetEnv?: string[];
+    }): {
+        status: number | null;
+        error?: Error;
+        stdout?: string;
+        stderr?: string;
+    };
+}
+export type HermesInstallStage = 'planned' | 'installed' | 'configured' | 'connected' | 'verified' | 'failed';
+export interface HermesInstallReceipt {
+    schemaVersion: 1;
+    projectId: string;
+    runtime: 'hermes';
+    stage: HermesInstallStage;
+    release: {
+        tag: string;
+        packageVersion: string | null;
+        commitSha: string;
+    };
+    profileName: string;
+    distributionDirectory: string;
+    profileDirectory: string;
+    backupDirectory: string | null;
+    runtimeIdentityBackup: string | null;
+    filesApplied: string[];
+    seedFilesApplied: string[];
+    selectedChannels: string[];
+    dryRun: boolean;
+    setupRequired: boolean;
+    modelCheckRequired: boolean;
+    gatewaySetupRequired: boolean;
+    resumeCommand: string;
+    completedAt: string | null;
+    failedStage?: string;
+}
+export declare function buildChildEnvironment(base: NodeJS.ProcessEnv, overlay?: NodeJS.ProcessEnv, unset?: string[], platform?: NodeJS.Platform): NodeJS.ProcessEnv;
+export declare function validateHermesManifest(manifest: HermesInstallManifestV2): void;
+export declare function resolveHermesCommand(hermesHome: string, platform: NodeJS.Platform, explicitCommand?: string): Promise<string>;
+export declare function installHermes(manifest: HermesInstallManifestV2, options?: HermesInstallOptions, runtime?: HermesInstallerRuntime): Promise<HermesInstallReceipt>;
+//# sourceMappingURL=hermes-install.d.ts.map

package/dist/hermes-install.d.ts.map

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