@event4u/agent-config 3.3.0 → 4.2.0

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"}

package/dist/install/wizard-plan.js

@@ -0,0 +1,184 @@
+/**
+ * Wizard-state → {@link PlanSource}[] translator — Phase B2.
+ *
+ * The Preact wizard collects high-level identifiers (tool IDs like
+ * `cursor` / `augment`, capability-pack IDs like `founder-mvp`) and is
+ * deliberately ignorant of filesystem layout. This module is the
+ * server-side bridge that expands those IDs into the low-level
+ * `(srcDir, destDir, toolId, kind)` tuples consumed by
+ * {@link buildInstallPlan}.
+ *
+ * Mirrors the canonical mapping tables in
+ * `scripts/install.py:2029-2222`:
+ *   - {@link USER_SCOPE_PATHS}     ← `USER_SCOPE_PATHS`
+ *   - {@link GLOBAL_DEPLOY_SOURCES} ← `_CLAUDE_SKILL_BUNDLE` + `GLOBAL_DEPLOY_SOURCES`
+ *
+ * Packs are intentionally NOT in this table: they are settings overlays
+ * (`packs/*.yml`), not file deployments. The 2PC settings write owns
+ * pack activation; the install plan only carries tool content.
+ */
+import { homedir } from 'node:os';
+import { isAbsolute, join, resolve } from 'node:path';
+import { buildInstallPlan } from './plan.js';
+/**
+ * Per-tool user-scope anchor directory, mirrored 1:1 from
+ * `scripts/install.py:USER_SCOPE_PATHS`. Values may use `~` for the
+ * user's home directory; {@link expandAnchor} resolves it server-side.
+ *
+ * Tools without a user-scope directory convention (e.g. `claude-desktop`
+ * which writes a single marker file, or `aider` which writes a single
+ * YAML file) are still listed so the wizard's bridge logic in Phase A6
+ * can resolve them via {@link expandAnchor} when needed.
+ */
+export const USER_SCOPE_PATHS = {
+    'claude-code': '~/.claude/',
+    'claude-desktop': '~/Library/Application Support/Claude/',
+    cursor: '~/.cursor/',
+    windsurf: '~/.codeium/windsurf/',
+    cline: '~/Documents/Cline/Rules/',
+    'gemini-cli': '~/.gemini/',
+    copilot: '~/.copilot/',
+    augment: '~/.augment/',
+    aider: '~/.aider.conf.yml',
+    codex: '~/.codex/',
+    roocode: '~/.roo/',
+    continue: '~/.continue/',
+    kilocode: '~/.kilocode/',
+    zed: '~/.config/zed/',
+    jetbrains: '~/.config/JetBrains/',
+    kiro: '~/.kiro/',
+    qoder: '~/.qoder/',
+    opencode: '~/.opencode/',
+    trae: '~/.trae/',
+    antigravity: '~/.agents/',
+    codebuddy: '~/.codebuddy/',
+    droid: '~/.factory/',
+    warp: '~/.warp/',
+};
+/**
+ * Universal Anthropic-shaped skill bundle deployed to markdown-skills
+ * tools. Mirrors `_CLAUDE_SKILL_BUNDLE` in `scripts/install.py`.
+ */
+const CLAUDE_SKILL_BUNDLE = [
+    ['.agent-src/rules', 'rules'],
+    ['.agent-src/skills', 'skills'],
+    ['.agent-src/personas', 'personas'],
+];
+/**
+ * Per-tool content deployment plan for `--global` installs. Each entry
+ * is a list of `(packageSrcRelative, destSubpath)` pairs.
+ *
+ * `packageSrcRelative` resolves against the agent-config package root;
+ * `destSubpath` is appended to `USER_SCOPE_PATHS[toolId]` (expanded).
+ *
+ * Mirrors `GLOBAL_DEPLOY_SOURCES` in `scripts/install.py:2178-2222`.
+ * Tools absent from this map have no deployable content in global scope
+ * — they either follow a marker-only convention (handled by bridges in
+ * Phase A6) or have no markdown convention at all.
+ */
+export const GLOBAL_DEPLOY_SOURCES = {
+    'claude-code': CLAUDE_SKILL_BUNDLE,
+    augment: [
+        ['.agent-src/rules', 'rules'],
+        ['.agent-src/skills', 'skills'],
+        ['.agent-src/commands', 'commands'],
+        ['.agent-src/contexts', 'contexts'],
+        ['.agent-src/personas', 'personas'],
+        ['.agent-src/templates', 'templates'],
+    ],
+    cursor: [
+        ['.agent-src/rules', 'rules'],
+        ['.agent-src/commands', 'commands'],
+        ['.agent-src/personas', 'personas'],
+    ],
+    windsurf: [
+        ['.agent-src/rules', 'rules'],
+    ],
+    cline: [
+        ['.agent-src/rules', ''],
+    ],
+    'gemini-cli': CLAUDE_SKILL_BUNDLE,
+    codex: CLAUDE_SKILL_BUNDLE,
+    continue: CLAUDE_SKILL_BUNDLE,
+    roocode: CLAUDE_SKILL_BUNDLE,
+    kilocode: CLAUDE_SKILL_BUNDLE,
+    qoder: CLAUDE_SKILL_BUNDLE,
+    opencode: CLAUDE_SKILL_BUNDLE,
+    trae: CLAUDE_SKILL_BUNDLE,
+    antigravity: CLAUDE_SKILL_BUNDLE,
+    codebuddy: CLAUDE_SKILL_BUNDLE,
+    droid: CLAUDE_SKILL_BUNDLE,
+    warp: CLAUDE_SKILL_BUNDLE,
+    kiro: [
+        ['.agent-src/rules', 'rules'],
+        ['.agent-src/skills', 'steering'],
+        ['.agent-src/personas', 'personas'],
+    ],
+};
+/**
+ * Resolve a `~/...` anchor against the user's home directory.
+ *
+ * Absolute paths (no `~` prefix) pass through unchanged. Empty string
+ * returns the home directory itself. Mirrors Python's `os.path.expanduser`.
+ */
+export function expandAnchor(anchor, home) {
+    const h = home ?? homedir();
+    if (anchor === '~')
+        return h;
+    if (anchor.startsWith('~/'))
+        return join(h, anchor.slice(2));
+    if (isAbsolute(anchor))
+        return anchor;
+    return resolve(anchor);
+}
+/**
+ * Expand the wizard's `toolIds` selection into a flat list of
+ * {@link PlanSource} tuples for the global install target.
+ *
+ * For each tool ID present in {@link GLOBAL_DEPLOY_SOURCES}, emit one
+ * `PlanSource` per `(packageSrcRelative, destSubpath)` pair, with:
+ *   - `srcDir`  = `packageRoot/packageSrcRelative`
+ *   - `destDir` = `expandAnchor(USER_SCOPE_PATHS[toolId])/destSubpath`
+ *   - `kind`    = `'deployed'` (we own these bytes)
+ *
+ * Tool IDs absent from {@link GLOBAL_DEPLOY_SOURCES} contribute zero
+ * sources — they are either marker-only (Phase A6 bridges handle them)
+ * or have no markdown convention. Unknown tool IDs (not in any map) are
+ * silently ignored — the detect/plan layer is the gatekeeper for
+ * enable/disable, not this expander.
+ */
+export function expandWizardSources(inputs) {
+    const { toolIds, packageRoot, home } = inputs;
+    const out = [];
+    for (const toolId of toolIds) {
+        const deploy = GLOBAL_DEPLOY_SOURCES[toolId];
+        const anchor = USER_SCOPE_PATHS[toolId];
+        if (!deploy || !anchor)
+            continue;
+        const destRoot = expandAnchor(anchor, home);
+        for (const [srcRel, destSub] of deploy) {
+            const srcDir = join(packageRoot, srcRel);
+            const destDir = destSub.length === 0 ? destRoot : join(destRoot, destSub);
+            out.push({ toolId, srcDir, destDir, kind: 'deployed' });
+        }
+    }
+    return out;
+}
+/**
+ * Build an {@link InstallPlan} directly from a wizard selection.
+ *
+ * Thin convenience over {@link expandWizardSources} +
+ * {@link buildInstallPlan}. Returns an empty-`filesByTool` plan when
+ * the selection contains zero deployable tool IDs — the wizard renders
+ * the "nothing to do" screen on that shape.
+ */
+export function buildPlanFromWizard(inputs) {
+    const sources = expandWizardSources(inputs);
+    return buildInstallPlan({
+        target: inputs.target,
+        root: inputs.root,
+        sources,
+        policy: inputs.policy,
+    });
+}
+//# sourceMappingURL=wizard-plan.js.map

package/dist/install/wizard-plan.js.map

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

package/dist/mcp/registry-manifest.json

@@ -1,15 +1,15 @@
 {
   "discovery": {
-    "artefact_count": 430,
-    "scanner_version": "80c8c0b8b827"
+    "artefact_count": 432,
+    "scanner_version": "b59a6d49e745"
   },
-  "generated_at": "2026-05-25",
+  "generated_at": "2026-05-27",
   "package": {
     "description": "Universal AI Agent OS \u2014 audited skills, governance rules, commands, and templates for AI coding tools (Claude Code, Cursor, Windsurf, Copilot).",
     "homepage": "https://github.com/event4u-app/agent-config#readme",
     "name": "@event4u/agent-config",
     "repository": "https://github.com/event4u-app/agent-config",
-    "version": "3.3.0"
+    "version": "4.2.0"
   },
   "registries": [
     {