@younndai/lyt 0.9.0

package/dist/flows/heal.d.ts

@@ -0,0 +1,29 @@
+import { type Runtime, type SymlinkResult } from "@younndai/lyt-skills";
+import { type AgentManualRuntime, type PatternHealResult } from "@younndai/lyt-vault";
+export type ManualHealAction = "installed" | "updated" | "skipped-symlink" | "refused-malformed" | "no-destination";
+export interface ManualHealEntry {
+    runtime: AgentManualRuntime;
+    action: ManualHealAction;
+    destinationPath: string | null;
+    message?: string;
+}
+export interface HealResult {
+    runtimes: readonly Runtime[];
+    skills: SymlinkResult;
+    manual: ManualHealEntry[];
+    patterns: PatternHealResult;
+}
+export interface HealPodOptions {
+    runtimesOverride?: readonly Runtime[] | undefined;
+    skillsSourceDir?: string | undefined;
+    skillTargetOverrides?: Partial<Record<Runtime, string>> | undefined;
+    collisionStampFn?: (() => string) | undefined;
+    homedirOverride?: string | undefined;
+    skillsCatalogDir?: string | undefined;
+    manualVersionOverride?: string | undefined;
+    patternsBundledDirOverride?: string | undefined;
+    patternBackupStampFn?: (() => string) | undefined;
+}
+export declare function healPod(opts?: HealPodOptions): Promise<HealResult>;
+export declare function summarizeHeal(heal: HealResult): string;
+//# sourceMappingURL=heal.d.ts.map

package/dist/flows/heal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal.d.ts","sourceRoot":"","sources":["../../src/flows/heal.ts"],"names":[],"mappings":"AA0CA,OAAO,EAA2B,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAE7B,gBAAgB,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC;IAElD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,oBAAoB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACpE,gBAAgB,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;IAE9C,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3C,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,oBAAoB,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CACnD;AAED,wBAAsB,OAAO,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8B5E;AAsDD,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAuBtD"}

package/dist/flows/heal.js

@@ -0,0 +1,146 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// W1.2 / OD-4 (2026-06-03) — idempotent pod heal.
+//
+// `healPod` re-aligns the three things a `lyt init` is meant to keep fresh,
+// composing primitives from lyt-skills + lyt-vault (the meta package is the
+// natural composer — see init-bootstrap.ts header):
+//
+// 1. SKILLS — symlinkSkillsTriRuntime into every DETECTED runtime
+// (collision-safe per D30.4: a user dir at a target is renamed
+// aside, never destroyed; a pristine copy is upgraded to a link;
+// an already-correct link short-circuits to already-linked).
+// 2. MANUAL — the agent manual marker block, replaced-or-appended in each
+// detected runtime's global instructions file. Malformed markers
+// are REFUSED (D9) — heal never silently mutates a hand-edited
+// file; it leaves it and reports `refused-malformed`.
+// 3. PATTERNS — healPatterns version-update (D30.3): add missing, replace
+// pristine-older (with backup), leave forks untouched.
+//
+// EVERY step is idempotent and non-fatal: a heal on an aligned pod is a no-op;
+// a per-runtime failure is recorded, not thrown, so a single `lyt init` never
+// fails because of heal (D30 never-fail). The CLI command runs this on the
+// fresh + re-init branches; unit tests drive it directly with seams so no real
+// ~/.claude / ~/.codex / ~/.agents is ever touched in CI.
+import { existsSync, lstatSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { symlinkSkillsTriRuntime } from "@younndai/lyt-skills";
+import { AgentManualMalformedMarkersError, detectInstalledRuntimes, generateAgentManual, healPatterns, replaceMarkerBlock, } from "@younndai/lyt-vault";
+export async function healPod(opts = {}) {
+    // Runtimes: explicit override, else detect installed ones (~/.claude, etc.).
+    const runtimes = opts.runtimesOverride ?? detectInstalledRuntimes(opts.homedirOverride);
+    // 1. Skills — collision-safe symlink into each detected runtime.
+    const skills = symlinkSkillsTriRuntime({
+        ...(opts.skillsSourceDir !== undefined ? { sourceDir: opts.skillsSourceDir } : {}),
+        runtimes,
+        ...(opts.skillTargetOverrides !== undefined
+            ? { targetDirOverrides: opts.skillTargetOverrides }
+            : {}),
+        ...(opts.collisionStampFn !== undefined ? { collisionStampFn: opts.collisionStampFn } : {}),
+    });
+    // 2. Manual — inject/refresh the marker block per runtime (non-fatal).
+    const manual = [];
+    for (const runtime of runtimes) {
+        manual.push(await injectManual(runtime, opts));
+    }
+    // 3. Patterns — version-update heal.
+    const patterns = healPatterns({
+        ...(opts.patternsBundledDirOverride !== undefined
+            ? { bundledDirOverride: opts.patternsBundledDirOverride }
+            : {}),
+        ...(opts.patternBackupStampFn !== undefined ? { stampFn: opts.patternBackupStampFn } : {}),
+    });
+    return { runtimes, skills, manual, patterns };
+}
+async function injectManual(runtime, opts) {
+    const gen = await generateAgentManual({
+        runtime: runtime,
+        install: true,
+        ...(opts.homedirOverride !== undefined ? { homedirOverride: opts.homedirOverride } : {}),
+        ...(opts.skillsCatalogDir !== undefined ? { skillsDirOverride: opts.skillsCatalogDir } : {}),
+        ...(opts.manualVersionOverride !== undefined
+            ? { versionOverride: opts.manualVersionOverride }
+            : {}),
+    });
+    const dest = gen.destinationPath;
+    if (dest === null) {
+        return { runtime, action: "no-destination", destinationPath: null };
+    }
+    // Symlink-refuse (mirrors the command's Sec-M1 defense): writeFileSync
+    // follows symlinks, so never write the manual through a planted link.
+    if (existsSync(dest) && lstatSync(dest).isSymbolicLink()) {
+        return {
+            runtime,
+            action: "skipped-symlink",
+            destinationPath: dest,
+            message: `${dest} is a symlink; refused to write the agent manual through it`,
+        };
+    }
+    let existing = "";
+    if (existsSync(dest))
+        existing = readFileSync(dest, "utf8");
+    try {
+        // force=false → malformed markers REFUSE (D9). Heal never silently
+        // overwrites a hand-edited file; it leaves it and reports.
+        const { result: next, replaced } = replaceMarkerBlock(existing, gen.content, dest, false);
+        const dir = dirname(dest);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(dest, next, "utf8");
+        return {
+            runtime,
+            action: replaced ? "updated" : "installed",
+            destinationPath: dest,
+        };
+    }
+    catch (err) {
+        if (err instanceof AgentManualMalformedMarkersError) {
+            return {
+                runtime,
+                action: "refused-malformed",
+                destinationPath: dest,
+                message: err.message,
+            };
+        }
+        throw err;
+    }
+}
+// Compact one-line summary for the CLI human output.
+export function summarizeHeal(heal) {
+    const skillCounts = new Map();
+    for (const r of heal.skills.results) {
+        skillCounts.set(r.status, (skillCounts.get(r.status) ?? 0) + 1);
+    }
+    const skillsParts = [...skillCounts.entries()]
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([status, n]) => `${n} ${status}`);
+    const manualParts = heal.manual.map((m) => `${m.runtime}:${m.action}`);
+    const patCounts = new Map();
+    for (const e of heal.patterns.entries) {
+        patCounts.set(e.action, (patCounts.get(e.action) ?? 0) + 1);
+    }
+    const patParts = [...patCounts.entries()]
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([action, n]) => `${n} ${action}`);
+    const runtimeList = heal.runtimes.length > 0 ? heal.runtimes.join(", ") : "(none detected)";
+    return [
+        `Heal — runtimes: ${runtimeList}`,
+        `  skills:   ${skillsParts.length > 0 ? skillsParts.join(", ") : "(no runtimes)"}`,
+        `  manual:   ${manualParts.length > 0 ? manualParts.join(", ") : "(no runtimes)"}`,
+        `  patterns: ${patParts.length > 0 ? patParts.join(", ") : "(none)"}`,
+    ].join("\n");
+}
+//# sourceMappingURL=heal.js.map

package/dist/flows/heal.js.map

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

package/dist/flows/init-bootstrap.d.ts

@@ -0,0 +1,93 @@
+import type { Client } from "@libsql/client";
+import { readIdentityCache, type FederationGhClient, type FederationInitBranch, type MaterializePodResult, type MeshGhClient, type VaultCloneFn } from "@younndai/lyt-vault";
+import type { HealResult } from "./heal.js";
+export type InitBootstrapBranch = "fresh" | "re-init" | "discovery" | "adopt";
+export type IntegrityStatus = "ok" | "missing" | "unparseable" | "orphaned-home-mesh";
+export interface IntegrityIssue {
+    vaultName: string;
+    status: IntegrityStatus;
+    error?: string;
+}
+export type DiscoveredRepoKind = "lyt-prefix" | "lyt-public-topic";
+export interface DiscoveredRepo {
+    fullName: string;
+    kind: DiscoveredRepoKind;
+    alreadyInRegistry: boolean;
+}
+export interface DiscoveryProbeResult {
+    repos: DiscoveredRepo[];
+}
+export interface DiscoveryProbe {
+    probe(handle: string): Promise<DiscoveryProbeResult>;
+}
+export interface InitBootstrapMeshAssignment {
+    meshRidHex: string;
+    meshName: string;
+    meshAutoCreated: boolean;
+    mainVaultName?: string;
+    mainVaultPath?: string;
+}
+export interface InitBootstrapFederation {
+    handle: string;
+    fedRidHex: string;
+    branch: FederationInitBranch;
+    localPath: string;
+    federationYonPath: string;
+    remoteCreated: boolean;
+    pushed: boolean;
+    remoteFullName: string;
+}
+export interface InitBootstrapAdopt {
+    podBranch: FederationInitBranch;
+    podHandle: string;
+    podLocalPath: string;
+    vaultsRecoveredFromManifest: number;
+    vaultsAcquired: number;
+    manifestSkipped: {
+        vaultName: string;
+        reason: string;
+    }[];
+    firstVaultCreated: boolean;
+    primaryVaultPath: string | null;
+    primaryMeshName: string | null;
+    reconciledVaultPaths: string[];
+}
+export interface InitBootstrapResult {
+    branch: InitBootstrapBranch;
+    meshAssignment?: InitBootstrapMeshAssignment;
+    federation?: InitBootstrapFederation;
+    integrityIssues?: IntegrityIssue[];
+    discoveredRepos?: DiscoveredRepo[];
+    adopt?: InitBootstrapAdopt;
+    adoptError?: {
+        reason: string;
+    };
+    heal?: HealResult;
+    reconciledVaultPaths?: string[];
+    publish?: MaterializePodResult;
+    durationMs: number;
+}
+export type InitBootstrapMode = "auto" | "custom" | "discover";
+export interface InitBootstrapCustomOverrides {
+    meshName?: string;
+    pushTarget?: string;
+    starterFigment?: boolean;
+}
+export interface InitBootstrapArgs {
+    mode: InitBootstrapMode;
+    meshGhClient?: MeshGhClient;
+    federationGhClient?: FederationGhClient;
+    vaultCloneFn?: VaultCloneFn;
+    registryDb?: Client;
+    nowIso?: string;
+    discoveryProbe?: DiscoveryProbe;
+    handle?: string;
+    customOverrides?: InitBootstrapCustomOverrides;
+    heal?: (() => Promise<HealResult>) | undefined;
+    materializePublish?: ((db: Client) => Promise<MaterializePodResult>) | undefined;
+    onPhase?: (op: string, label: string) => void | Promise<void>;
+}
+export declare function probeFreshState(registryDb?: Client): Promise<boolean>;
+export declare function resolveLocalFirst(cached: ReturnType<typeof readIdentityCache>): boolean;
+export declare function initBootstrapFlow(args: InitBootstrapArgs): Promise<InitBootstrapResult>;
+//# sourceMappingURL=init-bootstrap.d.ts.map

package/dist/flows/init-bootstrap.d.ts.map

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