@event4u/agent-config 3.3.0 → 4.1.0

package/dist/install/detect.js

@@ -0,0 +1,218 @@
+/**
+ * Detection layer — Phase A2 port of `scripts/install.py:detect_*`.
+ *
+ * Pure functions only: read once, return a plan. No side effects in
+ * the detection itself — atomic writes and conflict resolution happen
+ * in later phases against the data this module returns.
+ *
+ * Mirrors:
+ *   - `SCOPE_DETECT_MANIFESTS`            → {@link SCOPE_DETECT_MANIFESTS}
+ *   - `SCOPE_DETECT_AI_DIRS`              → {@link SCOPE_DETECT_AI_DIRS}
+ *   - `SCOPE_DETECT_AI_FILES`             → {@link SCOPE_DETECT_AI_FILES}
+ *   - `detect_scope(cwd)`                 → {@link detectScope}
+ *   - `detect_package_root(project_root)` → {@link detectPackageRoot}
+ *   - `detect_package_type(...)`          → {@link detectPackageType}
+ *
+ * v4 addition (no Python counterpart): {@link discoverPacks} walks the
+ * monorepo `packages/` tree to enumerate available packs.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+/**
+ * Settings-file name used as the strongest project-scope signal.
+ *
+ * Matches `SETTINGS_FILE` in `scripts/install.py`. Presence in `cwd`
+ * short-circuits scope detection to `'project'` without consulting
+ * the manifest / AI-tool lists.
+ */
+export const SETTINGS_FILE = '.agent-settings.yml';
+/**
+ * Manifest files that, when present, count as a project-shape signal.
+ *
+ * Listed in the order they are most commonly canonical; detection
+ * short-circuits on the first hit. `.git/` is intentionally absent —
+ * monorepos, dotfile-git repos, and non-Git workspaces all break it
+ * (ADR-007 D2).
+ */
+export const SCOPE_DETECT_MANIFESTS = [
+    'package.json',
+    'composer.json',
+    'pyproject.toml',
+    'Cargo.toml',
+    'go.mod',
+    'Gemfile',
+];
+/** Project-local AI-tool config directories that count as a presence signal. */
+export const SCOPE_DETECT_AI_DIRS = [
+    '.claude',
+    '.cursor',
+    '.windsurf',
+    '.augment',
+    '.clinerules',
+    '.copilot',
+    '.gemini',
+    '.codex',
+    '.aider',
+    '.continue',
+    '.roo',
+    '.kilocode',
+];
+/** Project-local AI-tool config files that count as a presence signal. */
+export const SCOPE_DETECT_AI_FILES = [
+    'CLAUDE.md',
+    'AGENTS.md',
+    'GEMINI.md',
+    '.windsurfrules',
+    '.aider.conf.yml',
+];
+/**
+ * Multi-signal scope detection (ADR-007 D2 / Phase 1.3).
+ *
+ * 1:1 port of `scripts/install.py:detect_scope`. Pure — no side effects.
+ */
+export function detectScope(cwd) {
+    if (existsSync(join(cwd, SETTINGS_FILE))) {
+        return { scope: 'project', reason: `existing ${SETTINGS_FILE}` };
+    }
+    const manifest = SCOPE_DETECT_MANIFESTS.find((m) => existsSync(join(cwd, m)));
+    const aiDir = SCOPE_DETECT_AI_DIRS.find((d) => isDir(join(cwd, d)));
+    const aiFile = SCOPE_DETECT_AI_FILES.find((f) => existsSync(join(cwd, f)));
+    if (manifest !== undefined && (aiDir !== undefined || aiFile !== undefined)) {
+        const marker = aiDir ?? aiFile;
+        return {
+            scope: 'prompt',
+            reason: `manifest (${manifest}) + AI-tool config (${marker ?? ''})`,
+        };
+    }
+    return { scope: 'global', reason: 'no project-scope signals' };
+}
+/**
+ * Map a {@link Scope} to the {@link InstallTarget} consumed by plan builder.
+ *
+ * `prompt` is treated as ambiguous — caller resolves via CLI flag or UI.
+ * Defaulting `prompt` to `global` here would silently swallow the signal.
+ */
+export function scopeToTarget(scope) {
+    if (scope === 'project')
+        return 'project';
+    if (scope === 'global')
+        return 'global';
+    return null;
+}
+/**
+ * Detect project shape from manifest markers — pure read of cwd.
+ *
+ * Manifest-to-kind mapping mirrors {@link SCOPE_DETECT_MANIFESTS}:
+ * `package.json` → npm, `composer.json` → composer, etc.
+ */
+export function detectProjectShape(root) {
+    const manifest = SCOPE_DETECT_MANIFESTS.find((m) => existsSync(join(root, m)));
+    if (manifest === undefined) {
+        return { kind: 'unknown', root, manifest: null };
+    }
+    const kind = {
+        'package.json': 'npm',
+        'composer.json': 'composer',
+        'pyproject.toml': 'pyproject',
+        'Cargo.toml': 'cargo',
+        'go.mod': 'go',
+        Gemfile: 'ruby',
+    }[manifest] ?? 'unknown';
+    return { kind, root, manifest };
+}
+/** Read AI-tool presence flags from `root`. Pure — no writes. */
+export function detectToolPresence(root) {
+    return {
+        augment: isDir(join(root, '.augment')),
+        claude: isDir(join(root, '.claude')),
+        cursor: isDir(join(root, '.cursor')),
+        cline: isDir(join(root, '.clinerules')),
+        windsurf: isDir(join(root, '.windsurf')) || existsSync(join(root, '.windsurfrules')),
+        agentsMd: existsSync(join(root, 'AGENTS.md')),
+    };
+}
+/**
+ * Discover packs under a workspace root (`packages/pack-*` convention).
+ *
+ * Returns absolute paths to every directory under `<workspace>/packages/`
+ * whose name starts with `pack-`. v4-only addition — the legacy Python
+ * installer has no equivalent because packs are a v4 concept.
+ */
+export function discoverPacks(workspaceRoot) {
+    const packagesDir = join(workspaceRoot, 'packages');
+    if (!isDir(packagesDir)) {
+        return [];
+    }
+    return readdirSync(packagesDir)
+        .filter((name) => name.startsWith('pack-'))
+        .map((name) => resolve(packagesDir, name))
+        .filter(isDir);
+}
+/**
+ * Locate the agent-config package root from a project root.
+ *
+ * 1:1 port of `scripts/install.py:detect_package_root` — prefers an
+ * npm-installed copy under `node_modules/@event4u/agent-config/`,
+ * falls back to the project root itself for in-package development
+ * (presence of `config/profiles/minimal.ini` is the development-mode
+ * signal in the Python script; we mirror it).
+ *
+ * Returns `null` instead of failing — caller decides UX (Python `fail`
+ * exits the process; the TS engine surfaces the error to the wizard).
+ */
+export function detectPackageRoot(projectRoot) {
+    const npmPath = join(projectRoot, 'node_modules', '@event4u', 'agent-config');
+    if (isDir(npmPath)) {
+        return resolve(npmPath);
+    }
+    if (existsSync(join(projectRoot, 'config', 'profiles', 'minimal.ini'))) {
+        return projectRoot;
+    }
+    return null;
+}
+/** Classify a package root as `npm` (under node_modules) or `local`. */
+export function detectPackageType(packageRoot) {
+    return packageRoot.split(/[\\/]/).includes('node_modules') ? 'npm' : 'local';
+}
+function isDir(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect a v3.x install at `~/.event4u/agent-config/` (or the override
+ * passed in). Returns `present: false` when the directory or the
+ * `VERSION` file is missing, or when the recorded major version is not
+ * `3.x`. The caller decides what to do with `present: true` — the wire
+ * route in `installRoute` exposes the structure 1:1.
+ */
+export function detectLegacyV3(opts = {}) {
+    const home = opts.home ?? homedir();
+    const path = join(home, '.event4u', 'agent-config');
+    const backupTarget = join(home, '.event4u', 'agent-config.v3.bak');
+    if (!isDir(path)) {
+        return { present: false, path, version: null, backupTarget };
+    }
+    const versionFile = join(path, 'VERSION');
+    if (!existsSync(versionFile)) {
+        return { present: false, path, version: null, backupTarget };
+    }
+    let raw = '';
+    try {
+        raw = readFileSync(versionFile, 'utf8').trim();
+    }
+    catch {
+        return { present: false, path, version: null, backupTarget };
+    }
+    const firstLine = raw.split('\n', 1)[0]?.trim() ?? '';
+    const major = firstLine.split('.')[0]?.trim();
+    if (major !== '3') {
+        return { present: false, path, version: firstLine || null, backupTarget };
+    }
+    return { present: true, path, version: firstLine, backupTarget };
+}
+//# sourceMappingURL=detect.js.map

package/dist/install/detect.js.map

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

package/dist/install/paths.js

@@ -0,0 +1,82 @@
+/**
+ * Centralised path resolution for the unified TS install engine.
+ *
+ * Council Finding #16: every downstream module reads paths from one
+ * place — no inline `os.tmpdir()` or `~/.event4u/...` literals scattered
+ * across A2–A6.
+ *
+ * All helpers accept an optional `home` argument so tests can drive
+ * platform behaviour (POSIX vs Windows env-var fallback) without
+ * mocking `node:os`. Production callers omit it and `os.homedir()` is
+ * consulted lazily.
+ *
+ * Platform notes:
+ *   - POSIX: `os.homedir()` reads `$HOME`.
+ *   - Windows: `os.homedir()` reads `$USERPROFILE`, then `$HOMEDRIVE+$HOMEPATH`.
+ *
+ * The install root and log path live under a fixed `.event4u/agent-config/`
+ * sub-tree so both platforms land on the same logical location.
+ */
+import { homedir, tmpdir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Sub-tree under the user's home where v4 installs land.
+ *
+ * Matches the legacy Python installer's target (`~/.event4u/agent-config/`)
+ * so v3 and v4 read/write the same physical tree and v3-detection (Phase E2)
+ * can introspect a prior install without a migration step.
+ */
+export const INSTALL_ROOT_SUBPATH = '.event4u/agent-config';
+/**
+ * Active transaction log filename written by Phase A4 atomic-writer.
+ *
+ * Per Phase A4 + council Finding #18: rotation produces sibling files
+ * (`install-log.<ISO>.jsonl.gz`); recovery only scans the active log.
+ */
+export const INSTALL_LOG_FILENAME = 'install-log.jsonl';
+/**
+ * Resolve the home directory.
+ *
+ * `home` override is accepted so tests can pin platform behaviour
+ * without mocking the `node:os` module. Empty / falsy override falls
+ * back to `os.homedir()`.
+ */
+function resolveHome(home) {
+    if (home && home.length > 0) {
+        return home;
+    }
+    const fromOs = homedir();
+    if (!fromOs) {
+        throw new Error('Cannot resolve home directory — both $HOME (POSIX) and $USERPROFILE (Windows) are unset.');
+    }
+    return fromOs;
+}
+/**
+ * Absolute path to the v4 install root: `~/.event4u/agent-config/`.
+ *
+ * Stable across platforms because the suffix is a POSIX-style join
+ * applied via `path.join`, which normalises separators per platform.
+ */
+export function getInstallRoot(home) {
+    return join(resolveHome(home), INSTALL_ROOT_SUBPATH);
+}
+/**
+ * Absolute path to the active transaction log:
+ * `~/.event4u/agent-config/install-log.jsonl`.
+ *
+ * Phase A4 writers append here on every successful atomic rename.
+ */
+export function getLogPath(home) {
+    return join(getInstallRoot(home), INSTALL_LOG_FILENAME);
+}
+/**
+ * OS-level temp directory.
+ *
+ * Wraps `os.tmpdir()` so callers funnel through one symbol — drop-in
+ * replacement when a future test harness needs to redirect temp writes
+ * to a scratch dir without monkey-patching `node:os`.
+ */
+export function getTempPath() {
+    return tmpdir();
+}
+//# sourceMappingURL=paths.js.map

package/dist/install/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/install/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAExD;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,IAAa;IAC9B,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC;IACzB,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACX,0FAA0F,CAC7F,CAAC;IACN,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IACxC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACpC,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW;IACvB,OAAO,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/install/plan.js

@@ -0,0 +1,157 @@
+/**
+ * Plan builder — Phase A3 port of `scripts/install.py:_build_install_plan`.
+ *
+ * Pure: walks one or more source directories, computes the target path
+ * + SHA-256 of every file, and returns a declarative {@link InstallPlan}.
+ * The applier (Phase A4) consumes the plan verbatim — it never recomputes
+ * paths or re-reads the source tree.
+ *
+ * Mirrors:
+ *   - `_sha256_of_file(path)`           → {@link sha256File}
+ *   - `_file_entry(path, kind, ...)`    → {@link fileEntry}
+ *   - `_files_by_tool_from_deploy(...)` → buildInstallPlan loop
+ *   - `_copy_dir_dereferencing_symlinks` walk → {@link walkSourceTree}
+ *
+ * v4 simplifies the Python shape: instead of three helper tables
+ * (`GLOBAL_DEPLOY_SOURCES` × `USER_SCOPE_PATHS` × `_bridge_marker`) the
+ * planner receives a flat list of `(srcDir, destDir, toolId, kind)`
+ * tuples. The mapping table lives in a higher layer (B0 dispatcher) so
+ * the planner stays a pure file walker.
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+/**
+ * Hex SHA-256 of `path` content, or `null` if unreadable.
+ *
+ * 1:1 port of `_sha256_of_file`. Bridges intentionally skip this and
+ * pass `null` (their content is a pointer, not committed bytes).
+ */
+export function sha256File(path) {
+    try {
+        const data = readFileSync(path);
+        return createHash('sha256').update(data).digest('hex');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build one v2 `files[]` entry.
+ *
+ * 1:1 port of `_file_entry(path, kind, hash_content=...)`. `hashContent`
+ * toggles SHA-256 computation: deployed/marker pass `true`, bridges pass
+ * `false` (sha256 stays `null`).
+ */
+export function fileEntry(path, kind, options) {
+    return {
+        path,
+        kind,
+        sha256: options.hashContent ? sha256File(path) : null,
+    };
+}
+/**
+ * Recursively list every file under `dir` (depth-first, sorted).
+ *
+ * Symlinks are followed via `statSync` (matches Python's
+ * `_copy_dir_dereferencing_symlinks` behaviour). Missing directories
+ * return `[]` rather than throwing — caller already validated `srcDir`.
+ */
+export function walkSourceTree(dir) {
+    const out = [];
+    walkInto(dir, out);
+    return out;
+}
+function walkInto(dir, out) {
+    let entries;
+    try {
+        entries = readdirSync(dir).sort();
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        const full = join(dir, name);
+        let isDir;
+        try {
+            isDir = statSync(full).isDirectory();
+        }
+        catch {
+            continue;
+        }
+        if (isDir) {
+            walkInto(full, out);
+        }
+        else {
+            out.push(full);
+        }
+    }
+}
+/**
+ * Build a declarative install plan.
+ *
+ * For each {@link PlanSource}, walks `srcDir` and emits one {@link FileEntry}
+ * per file with `path = destDir + (file path relative to srcDir)` and a
+ * fresh SHA-256 of the source file (computed once, never recomputed by
+ * the applier). Bridges (`kind=bridge`) keep `sha256=null` per the
+ * Python schema.
+ *
+ * The applier (Phase A4) is path-only — it does not re-walk `srcDir`
+ * and does not re-hash. The plan is the source of truth.
+ */
+export function buildInstallPlan(inputs) {
+    const filesByTool = {};
+    for (const source of inputs.sources) {
+        const bucket = filesByTool[source.toolId] ?? [];
+        const files = walkSourceTree(source.srcDir);
+        for (const srcFile of files) {
+            const rel = relative(source.srcDir, srcFile);
+            const destPath = resolve(source.destDir, rel);
+            bucket.push(fileEntry(srcFile, source.kind, {
+                hashContent: source.kind !== 'bridge',
+            }));
+            // Override `path` so the entry reflects the *target* (the
+            // applier writes here), not the source we read from.
+            bucket[bucket.length - 1] = {
+                ...bucket[bucket.length - 1],
+                path: destPath,
+            };
+        }
+        filesByTool[source.toolId] = bucket;
+    }
+    // Ensure every requested toolId appears, even with zero files —
+    // mirrors `_files_by_tool_from_deploy` emitting `[]` so a shrinking
+    // install actually shrinks the recorded inventory.
+    for (const source of inputs.sources) {
+        if (!(source.toolId in filesByTool)) {
+            filesByTool[source.toolId] = [];
+        }
+    }
+    return {
+        version: 2,
+        target: inputs.target,
+        root: inputs.root,
+        filesByTool,
+        mergedKeysByTool: {},
+        policy: inputs.policy,
+    };
+}
+/**
+ * True when the plan would not modify any file on disk.
+ *
+ * Wizard renders the "nothing to do" screen on `true` (Phase B2).
+ */
+export function isEmptyPlan(plan) {
+    for (const entries of Object.values(plan.filesByTool)) {
+        if (entries.length > 0) {
+            return false;
+        }
+    }
+    for (const entries of Object.values(plan.mergedKeysByTool)) {
+        if (entries.length > 0) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=plan.js.map

package/dist/install/plan.js.map

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

package/dist/install/txlog.js

@@ -0,0 +1,140 @@
+/**
+ * Transaction log — Phase A4 (council Finding #18).
+ *
+ * Append-only JSONL at `getLogPath()` (`~/.event4u/agent-config/install-log.jsonl`).
+ * Each successful atomic write appends one entry; recovery on crash is
+ * `tail -n` + reverse-apply. No PID lockfile (per Phase-A4 decision 8).
+ *
+ * Rotation: 10 MB OR 30 days, whichever first. Rotated copies move to
+ * `install-log.<ISO>.jsonl.gz` siblings; recovery never scans them.
+ *
+ * Recovery cap: at most the **last 500 entries** of the active log are
+ * scanned. Older incomplete tails are treated as abandoned and surfaced
+ * to the wizard as "previous run aborted; ignoring".
+ */
+import { createGzip } from 'node:zlib';
+import { createReadStream, createWriteStream, existsSync, readFileSync, renameSync, statSync, unlinkSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { atomicAppendLine } from './atomic.js';
+/** Rotate the active log when it reaches this size (council Finding #18). */
+export const ROTATION_MAX_BYTES = 10 * 1024 * 1024;
+/** Rotate the active log when its first entry is older than this (ms). */
+export const ROTATION_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
+/** Recovery scans at most the last N entries of the active log. */
+export const RECOVERY_DEPTH_CAP = 500;
+/** Append one entry to the active log, rotating first if thresholds tripped. */
+export function appendTxLog(logPath, entry) {
+    if (shouldRotate(logPath)) {
+        rotateLogSync(logPath);
+    }
+    atomicAppendLine(logPath, JSON.stringify(entry));
+}
+/**
+ * Read at most the last {@link RECOVERY_DEPTH_CAP} entries from the active log.
+ *
+ * Returns entries in chronological order (oldest of the tail first).
+ * Malformed lines are dropped silently \u2014 partial-write tails should not
+ * crash recovery.
+ */
+export function readRecentEntries(logPath) {
+    if (!existsSync(logPath)) {
+        return [];
+    }
+    const raw = readFileSync(logPath, 'utf8');
+    const lines = raw.split('\n').filter((l) => l.length > 0);
+    const tail = lines.slice(-RECOVERY_DEPTH_CAP);
+    const out = [];
+    for (const line of tail) {
+        const parsed = tryParseEntry(line);
+        if (parsed !== null) {
+            out.push(parsed);
+        }
+    }
+    return out;
+}
+/**
+ * True when the active log breaches one of the rotation thresholds.
+ *
+ * Size threshold trips on byte-count alone; age threshold reads the
+ * first line and compares its `ts` against `now`.
+ */
+export function shouldRotate(logPath, now = new Date()) {
+    if (!existsSync(logPath)) {
+        return false;
+    }
+    let size = 0;
+    try {
+        size = statSync(logPath).size;
+    }
+    catch {
+        return false;
+    }
+    if (size >= ROTATION_MAX_BYTES) {
+        return true;
+    }
+    const firstTs = readFirstTimestamp(logPath);
+    if (firstTs === null) {
+        return false;
+    }
+    return now.getTime() - firstTs >= ROTATION_MAX_AGE_MS;
+}
+/**
+ * Rotate the active log to `install-log.<ISO>.jsonl.gz` and remove the original.
+ *
+ * Sync wrapper around the async gzip pipeline so callers stay sequential.
+ * `appendTxLog` blocks on this \u2014 acceptable: rotations are rare (10 MB
+ * or 30 days) and the gzip is fire-and-forget afterwards.
+ */
+export function rotateLogSync(logPath) {
+    if (!existsSync(logPath)) {
+        return;
+    }
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const rotated = logPath.replace(/\.jsonl$/, `.${stamp}.jsonl`);
+    renameSync(logPath, rotated);
+    // Best-effort gzip in the background; failure is non-fatal because
+    // the rotated `.jsonl` is already a valid recovery artefact.
+    void gzipInPlace(rotated).catch(() => { });
+}
+async function gzipInPlace(source) {
+    const target = `${source}.gz`;
+    await pipeline(createReadStream(source), createGzip(), createWriteStream(target));
+    try {
+        unlinkSync(source);
+    }
+    catch {
+        /* swallow \u2014 gzip succeeded, leak is acceptable */
+    }
+}
+function readFirstTimestamp(logPath) {
+    try {
+        const raw = readFileSync(logPath, 'utf8');
+        const firstLine = raw.split('\n', 1)[0] ?? '';
+        const parsed = tryParseEntry(firstLine);
+        if (parsed === null)
+            return null;
+        const t = Date.parse(parsed.ts);
+        return Number.isFinite(t) ? t : null;
+    }
+    catch {
+        return null;
+    }
+}
+function tryParseEntry(line) {
+    try {
+        const obj = JSON.parse(line);
+        if (typeof obj.ts !== 'string' || typeof obj.kind !== 'string' || typeof obj.path !== 'string') {
+            return null;
+        }
+        return obj;
+    }
+    catch {
+        return null;
+    }
+}
+/** Resolve the directory holding `logPath` \u2014 helper for callers (apply.ts). */
+export function txLogDir(logPath) {
+    return dirname(logPath);
+}
+//# sourceMappingURL=txlog.js.map

package/dist/install/txlog.js.map

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

package/dist/install/types.js

@@ -0,0 +1,19 @@
+/**
+ * Core types for the unified TypeScript install engine (v4.0.0).
+ *
+ * Mirrors the on-disk schema used by the legacy Python installer
+ * (`scripts/install.py`) so the v4 engine reads/writes the same
+ * `~/.event4u/agent-config/` tree and v2 manifest entries without a
+ * migration step.
+ *
+ * Phase A1 — foundation. Sub-types referenced by `detect`, `plan`,
+ * apply, and conflict-resolution modules. Pure types, no runtime
+ * dependencies.
+ *
+ * Reference: `scripts/install.py`
+ *   - `_file_entry()` → {@link FileEntry}
+ *   - `class ConflictPolicy` → {@link ConflictPolicy}
+ *   - v2 manifest `files_by_tool` → {@link InstallPlan.filesByTool}
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/install/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/install/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}