silvermoon 0.3.0-rc.2 → 0.4.0

package/dist/src/foundation/idea-template/templates.js

@@ -0,0 +1,265 @@
+import { resolveContentTemplateLanguage } from "../language/index.js";
+export const IDEA_TEMPLATE = `# Replace with a concise action-oriented title
+
+<!--
+Keep this direction card brief: aim for 200-400 words.
+Link existing detail instead of copying it. Add detail only when a concrete
+decision, risk, or disagreement requires it.
+-->
+
+## Problem
+
+<!-- State the current problem in one or two sentences. -->
+
+## Outcome
+
+<!-- State the externally meaningful change in one or two sentences. -->
+
+## Boundaries
+
+<!-- List one to three material constraints or explicit exclusions. -->
+
+## Acceptance criteria
+
+<!-- List no more than three observable outcomes. Do not describe implementation steps. -->
+
+## Next step
+
+<!-- Keep only the highest-priority preparation action or decision. Remove it before acceptance. -->
+`;
+export const IMPLEMENTATION_TEMPLATE = `# Implementation
+
+<!--
+During preparation, replace every placeholder below with a lightweight first
+version before requesting Idea acceptance. Keep it high-level and provisional:
+Idea acceptance does not cover this contract. Refine it during implementation.
+-->
+
+## Steps
+
+<!--
+Give every step a stable I-Sxx identifier and a level-three heading.
+Start with no more than three steps. Add another only for independently
+necessary work. Describe what changes now and its material boundaries without
+repeating the idea or anticipating deployment.
+Do not use task-list checkboxes in this document.
+-->
+
+### I-S01: Step title
+
+<!-- Describe this implementation step. -->
+
+## Acceptance criteria
+
+<!--
+Give every criterion a stable I-ACxx identifier and a level-three heading.
+Start with no more than three criteria. Add another only when it requires
+independent proof.
+Describe both the observable outcome and the method that proves it.
+Do not create a separate validation section or use task-list checkboxes.
+-->
+
+### I-AC01: Criterion title
+
+<!-- Describe the required outcome and how an Agent can prove it. -->
+`;
+export const DEPLOYMENT_TEMPLATE = `# Deployment
+
+<!--
+During preparation, replace every placeholder below with a lightweight first
+version before requesting Idea acceptance. Keep it high-level and provisional:
+Idea acceptance does not cover this contract. Refine it during deployment.
+-->
+
+## Steps
+
+<!--
+Give every step a stable D-Sxx identifier and a level-three heading.
+Start with no more than three steps. Add another only for independently
+necessary external work. Describe deployment or external-world verification
+without recapping implementation.
+Do not use task-list checkboxes in this document.
+-->
+
+### D-S01: Step title
+
+<!-- Describe this deployment or external-verification step. -->
+
+## Acceptance criteria
+
+<!--
+Give every criterion a stable D-ACxx identifier and a level-three heading.
+Start with no more than three criteria. Add another only when it requires
+independent external proof.
+Describe both the observable external outcome and the method that proves it.
+Do not create a separate validation section or use task-list checkboxes.
+-->
+
+### D-AC01: Criterion title
+
+<!-- Describe the required external outcome and how an Agent can prove it. -->
+`;
+export const LEDGER_TEMPLATE = `# Ledger
+
+<!-- During preparation, mirror the lightweight contract versions below and keep every item unchecked. -->
+
+## Implementation
+
+### Implementation steps
+
+- [ ] **I-S01:** Step title
+
+### Implementation acceptance criteria
+
+- [ ] **I-AC01:** Criterion title
+
+## Deployment
+
+### Deployment steps
+
+- [ ] **D-S01:** Step title
+
+### Deployment acceptance criteria
+
+- [ ] **D-AC01:** Criterion title
+`;
+const CHINESE_IDEA_TEMPLATE = `# 将标题替换为简洁的“动作 + 目标”
+
+<!--
+把本文档保持为轻量方向卡，默认控制在 200-400 字。
+已有细节用链接引用，不要复制。只有真实出现的决策、风险或分歧才值得增加内容。
+-->
+
+## 问题
+
+<!-- 用一两句话说明当前问题。 -->
+
+## 结果
+
+<!-- 用一两句话说明应当实现的、对外有意义的变化。 -->
+
+## 边界
+
+<!-- 列出一至三条重要约束或明确排除项。 -->
+
+## 验收标准
+
+<!-- 最多列出三条可观察结果，不要描述实现步骤。 -->
+
+## 下一步
+
+<!-- 只保留当前最高优先级的准备动作或决定；验收前删除本节。 -->
+`;
+const CHINESE_IMPLEMENTATION_TEMPLATE = `# Implementation
+
+<!--
+准备阶段必须先把下方所有占位替换为轻量初版，再请求构想验收。
+保持高层、可调整；构想验收不包含本契约，实施阶段再逐步细化。
+-->
+
+## Steps
+
+<!--
+为每个步骤分配稳定的 I-Sxx 标识符和三级标题。
+先写不超过三个步骤；只有存在必须独立完成的工作时才增加。
+说明当前修改及其重要边界，不要复述 idea，也不要提前描述部署。
+不要在本文档中使用任务列表复选框。
+-->
+
+### I-S01: 步骤标题
+
+<!-- 描述该实施步骤。 -->
+
+## Acceptance criteria
+
+<!--
+为每项标准分配稳定的 I-ACxx 标识符和三级标题。
+先写不超过三项标准；只有需要独立证明时才增加。
+同时说明可观察结果及其证明方法。
+不要创建单独的验证章节，也不要使用任务列表复选框。
+-->
+
+### I-AC01: 标准标题
+
+<!-- 描述所需结果以及 Agent 如何证明该结果。 -->
+`;
+const CHINESE_DEPLOYMENT_TEMPLATE = `# Deployment
+
+<!--
+准备阶段必须先把下方所有占位替换为轻量初版，再请求构想验收。
+保持高层、可调整；构想验收不包含本契约，部署阶段再逐步细化。
+-->
+
+## Steps
+
+<!--
+为每个步骤分配稳定的 D-Sxx 标识符和三级标题。
+先写不超过三个步骤；只有存在必须独立完成的外部工作时才增加。
+描述部署或现实世界验证，不要复述实现过程。
+不要在本文档中使用任务列表复选框。
+-->
+
+### D-S01: 步骤标题
+
+<!-- 描述该部署或外部验证步骤。 -->
+
+## Acceptance criteria
+
+<!--
+为每项标准分配稳定的 D-ACxx 标识符和三级标题。
+先写不超过三项标准；只有需要独立的外部证明时才增加。
+同时说明可观察的外部结果及其证明方法。
+不要创建单独的验证章节，也不要使用任务列表复选框。
+-->
+
+### D-AC01: 标准标题
+
+<!-- 描述所需外部结果以及 Agent 如何证明该结果。 -->
+`;
+const CHINESE_LEDGER_TEMPLATE = `# Ledger
+
+<!-- 准备阶段同步下方轻量契约初版，并保持所有条目未勾选。 -->
+
+## Implementation
+
+### Implementation steps
+
+- [ ] **I-S01:** 步骤标题
+
+### Implementation acceptance criteria
+
+- [ ] **I-AC01:** 标准标题
+
+## Deployment
+
+### Deployment steps
+
+- [ ] **D-S01:** 步骤标题
+
+### Deployment acceptance criteria
+
+- [ ] **D-AC01:** 标准标题
+`;
+/** @pure */
+export function ideaTemplates(contentLanguage) {
+    const template = resolveContentTemplateLanguage(contentLanguage);
+    if (template.tag === "zh-CN") {
+        return {
+            idea: CHINESE_IDEA_TEMPLATE,
+            implementation: CHINESE_IMPLEMENTATION_TEMPLATE,
+            deployment: CHINESE_DEPLOYMENT_TEMPLATE,
+            ledger: CHINESE_LEDGER_TEMPLATE,
+            localized: template.localized,
+            templateLanguage: template.tag,
+        };
+    }
+    return {
+        idea: IDEA_TEMPLATE,
+        implementation: IMPLEMENTATION_TEMPLATE,
+        deployment: DEPLOYMENT_TEMPLATE,
+        ledger: LEDGER_TEMPLATE,
+        localized: template.localized,
+        templateLanguage: template.tag,
+    };
+}
+//# sourceMappingURL=templates.js.map

package/dist/src/foundation/idea-template/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../../src/foundation/idea-template/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAEtE,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B5B,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCtC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmClC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuB9B,CAAC;AAEF,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B7B,CAAC;AAEF,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCvC,CAAC;AAEF,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCnC,CAAC;AAEF,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuB/B,CAAC;AAEF,YAAY;AACZ,MAAM,UAAU,aAAa,CAAC,eAAuB;IACnD,MAAM,QAAQ,GAAG,8BAA8B,CAAC,eAAe,CAAC,CAAC;IACjE,IAAI,QAAQ,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,qBAAqB;YAC3B,cAAc,EAAE,+BAA+B;YAC/C,UAAU,EAAE,2BAA2B;YACvC,MAAM,EAAE,uBAAuB;YAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,gBAAgB,EAAE,QAAQ,CAAC,GAAG;SAC/B,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,cAAc,EAAE,uBAAuB;QACvC,UAAU,EAAE,mBAAmB;QAC/B,MAAM,EAAE,eAAe;QACvB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,gBAAgB,EAAE,QAAQ,CAAC,GAAG;KAC/B,CAAC;AACJ,CAAC"}

package/dist/src/foundation/installation/device-readiness.d.ts

@@ -0,0 +1,94 @@
+import { lstat, mkdir, readFile, realpath, writeFile } from "node:fs/promises";
+declare const CACHE_TTL_MS: number;
+declare const PERSONAL_SKILL_PATHS: readonly [".agents/skills/silvermoon", ".copilot/skills/silvermoon"];
+interface ReadinessFileSystem {
+    lstat: typeof lstat;
+    mkdir: typeof mkdir;
+    readFile: typeof readFile;
+    realpath: typeof realpath;
+    writeFile: typeof writeFile;
+}
+export declare function inspectRuntimeUpdate({ currentVersion, filesystem, force, home, now, requestLatest, }: {
+    currentVersion: string | null;
+    filesystem?: ReadinessFileSystem;
+    force?: boolean;
+    home?: string;
+    now?: number;
+    requestLatest?: () => Promise<string>;
+}): Promise<{
+    status: "unavailable";
+    currentVersion: string | null;
+    source: "runtime";
+    summary: string;
+} | {
+    summary: string;
+    lastSuccessfulCheck?: {
+        checkedAt: string;
+        latestVersion: string;
+    };
+    status: "unavailable";
+    currentVersion: string | null;
+    source: "registry";
+} | {
+    status: "unavailable";
+    currentVersion: string | null;
+    source: "cache" | "registry";
+    summary: string;
+} | {
+    summary?: string;
+    status: "current" | "available";
+    currentVersion: string | null;
+    latestVersion: string;
+    checkedAt: string;
+    source: "cache" | "registry";
+}>;
+export declare function inspectPersonalSkill({ filesystem, home, runtimeSource, skillRoot, }: {
+    filesystem?: ReadinessFileSystem;
+    home?: string;
+    runtimeSource: string;
+    skillRoot?: string;
+}): Promise<{
+    status: "source-checkout" | "managed-by-host";
+    expectedRoot: string;
+    paths: never[];
+    remediation?: never;
+    summary?: never;
+    invalidPaths?: never;
+} | {
+    status: "invalid";
+    expectedRoot: string;
+    paths: never[];
+    remediation: string;
+    summary: string;
+    invalidPaths?: never;
+} | {
+    status: "invalid";
+    expectedRoot: string;
+    paths: string[];
+    summary: string;
+    remediation?: never;
+    invalidPaths?: never;
+} | {
+    status: "mismatched";
+    expectedRoot: string;
+    paths: string[];
+    invalidPaths: string[];
+    remediation: string;
+    summary?: never;
+} | {
+    status: "missing";
+    expectedRoot: string;
+    paths: string[];
+    remediation: string;
+    summary?: never;
+    invalidPaths?: never;
+} | {
+    status: "ready";
+    expectedRoot: string;
+    paths: string[];
+    remediation?: never;
+    summary?: never;
+    invalidPaths?: never;
+}>;
+export { CACHE_TTL_MS, PERSONAL_SKILL_PATHS };
+//# sourceMappingURL=device-readiness.d.ts.map

package/dist/src/foundation/installation/device-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-readiness.d.ts","sourceRoot":"","sources":["../../../../src/foundation/installation/device-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACV,MAAM,kBAAkB,CAAC;AAa1B,QAAA,MAAM,YAAY,QAAsB,CAAC;AACzC,QAAA,MAAM,oBAAoB,sEAGhB,CAAC;AAEX,UAAU,mBAAmB;IAC3B,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,SAAS,EAAE,OAAO,SAAS,CAAC;CAC7B;AA4DD,wBAAsB,oBAAoB,CAAC,EACzC,cAAc,EACd,UAA4D,EAC5D,KAAa,EACb,IAAgB,EAChB,GAAgB,EAChB,aAA8B,GAC/B,EAAE;IACD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;;;;;;;;;;;;;;;;;;;;;;;;;;GA8HA;AAED,wBAAsB,oBAAoB,CAAC,EACzC,UAA4D,EAC5D,IAAgB,EAChB,aAAa,EACb,SAAyB,GAC1B,EAAE;IACD,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiFA;AAED,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/src/foundation/installation/device-readiness.js

@@ -0,0 +1,274 @@
+import { lstat, mkdir, readFile, realpath, writeFile, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { compareSemanticVersions, parseSemanticVersion } from "./rules.js";
+const packageRoot = fileURLToPath(new URL(import.meta.url.endsWith(".ts") ? "../../.." : "../../../..", import.meta.url));
+const packagedSkill = resolve(packageRoot, "skills", "silvermoon");
+const CACHE_PATH = ".cache/silvermoon/runtime-latest.json";
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const PERSONAL_SKILL_PATHS = [
+    ".agents/skills/silvermoon",
+    ".copilot/skills/silvermoon",
+];
+function errorCode(error) {
+    return error instanceof Error && "code" in error
+        && typeof error.code === "string" ? error.code : undefined;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function validCache(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const cache = value;
+    return cache.version === 1
+        && cache.channel === "latest"
+        && typeof cache.checkedAt === "string"
+        && Number.isFinite(Date.parse(cache.checkedAt))
+        && parseSemanticVersion(cache.latestVersion) !== null;
+}
+async function readCache(path, filesystem) {
+    try {
+        const parsed = JSON.parse(await filesystem.readFile(path, "utf8"));
+        return validCache(parsed) ? parsed : null;
+    }
+    catch (error) {
+        const code = errorCode(error);
+        if (code === "ENOENT" || error instanceof SyntaxError)
+            return null;
+        throw error;
+    }
+}
+async function registryLatest() {
+    const response = await fetch("https://registry.npmjs.org/silvermoon/latest", {
+        headers: { accept: "application/json" },
+        signal: AbortSignal.timeout(5000),
+    });
+    if (!response.ok) {
+        throw new Error(`npm registry returned HTTP ${response.status}`);
+    }
+    const body = await response.json();
+    const version = body && typeof body === "object" && "version" in body
+        ? body.version
+        : null;
+    if (typeof version !== "string" || parseSemanticVersion(version) === null) {
+        throw new Error("npm registry returned an invalid latest version");
+    }
+    return version;
+}
+export async function inspectRuntimeUpdate({ currentVersion, filesystem = { lstat, mkdir, readFile, realpath, writeFile }, force = false, home = homedir(), now = Date.now(), requestLatest = registryLatest, }) {
+    const cachePath = resolve(home, CACHE_PATH);
+    if (!Number.isFinite(now)) {
+        return {
+            status: "unavailable",
+            currentVersion,
+            source: "runtime",
+            summary: "The runtime freshness clock is invalid.",
+        };
+    }
+    if (parseSemanticVersion(currentVersion) === null) {
+        return {
+            status: "unavailable",
+            currentVersion,
+            source: "runtime",
+            summary: "The running Silvermoon package has an invalid version.",
+        };
+    }
+    let cached = null;
+    let cacheWarning;
+    try {
+        cached = await readCache(cachePath, filesystem);
+    }
+    catch (error) {
+        cacheWarning = `Cannot read the runtime freshness cache: ${errorMessage(error)}`;
+    }
+    const checkedAt = cached ? Date.parse(cached.checkedAt) : Number.NaN;
+    let latestVersion;
+    let source;
+    let latestCheckedAt;
+    if (!force && cached && now - checkedAt >= 0 && now - checkedAt < CACHE_TTL_MS) {
+        latestVersion = cached.latestVersion;
+        source = "cache";
+        latestCheckedAt = cached.checkedAt;
+    }
+    else {
+        try {
+            latestVersion = await requestLatest();
+        }
+        catch (error) {
+            return {
+                status: "unavailable",
+                currentVersion,
+                source: "registry",
+                ...(cached === null
+                    ? {}
+                    : {
+                        lastSuccessfulCheck: {
+                            checkedAt: cached.checkedAt,
+                            latestVersion: cached.latestVersion,
+                        },
+                    }),
+                summary: [
+                    cacheWarning,
+                    `Cannot confirm the latest Silvermoon version: ${errorMessage(error)}`,
+                ].filter(Boolean).join(" "),
+            };
+        }
+        if (parseSemanticVersion(latestVersion) === null) {
+            return {
+                status: "unavailable",
+                currentVersion,
+                source: "registry",
+                summary: [
+                    cacheWarning,
+                    "Runtime latest resolver returned an invalid version.",
+                ].filter(Boolean).join(" "),
+            };
+        }
+        latestCheckedAt = new Date(now).toISOString();
+        try {
+            await filesystem.mkdir(resolve(cachePath, ".."), { recursive: true });
+            await filesystem.writeFile(cachePath, `${JSON.stringify({
+                version: 1,
+                channel: "latest",
+                checkedAt: latestCheckedAt,
+                latestVersion,
+            })}\n`, { mode: 0o600 });
+        }
+        catch (error) {
+            const comparison = compareSemanticVersions(currentVersion, latestVersion);
+            const updateAvailable = comparison !== null && comparison < 0;
+            const summaries = [
+                cacheWarning,
+                updateAvailable
+                    ? `Upgrade the global Silvermoon runtime to ${latestVersion}.`
+                    : undefined,
+                `Confirmed the latest Silvermoon version but could not cache the result: ${errorMessage(error)}`,
+            ].filter((value) => value !== undefined);
+            return {
+                status: updateAvailable
+                    ? "available"
+                    : "current",
+                currentVersion,
+                latestVersion,
+                checkedAt: latestCheckedAt,
+                source: "registry",
+                summary: summaries.join(" "),
+            };
+        }
+        source = "registry";
+    }
+    const comparison = compareSemanticVersions(currentVersion, latestVersion);
+    if (comparison === null) {
+        return {
+            status: "unavailable",
+            currentVersion,
+            source,
+            summary: "Cannot compare the running and latest Silvermoon versions.",
+        };
+    }
+    const updateAvailable = comparison < 0;
+    const summaries = [
+        cacheWarning,
+        updateAvailable
+            ? `Upgrade the global Silvermoon runtime to ${latestVersion}.`
+            : undefined,
+    ].filter((value) => value !== undefined);
+    return {
+        status: updateAvailable ? "available" : "current",
+        currentVersion,
+        latestVersion,
+        checkedAt: latestCheckedAt,
+        source,
+        ...(summaries.length === 0 ? {} : { summary: summaries.join(" ") }),
+    };
+}
+export async function inspectPersonalSkill({ filesystem = { lstat, mkdir, readFile, realpath, writeFile }, home = homedir(), runtimeSource, skillRoot = packagedSkill, }) {
+    if (runtimeSource !== "global") {
+        return {
+            status: runtimeSource === "source-checkout"
+                ? "source-checkout"
+                : "managed-by-host",
+            expectedRoot: resolve(skillRoot),
+            paths: [],
+        };
+    }
+    let expectedRoot = resolve(skillRoot);
+    try {
+        expectedRoot = await filesystem.realpath(skillRoot);
+        await filesystem.readFile(resolve(expectedRoot, "SKILL.md"), "utf8");
+    }
+    catch (error) {
+        return {
+            status: "invalid",
+            expectedRoot,
+            paths: [],
+            remediation: `Repair the Silvermoon installation so ${expectedRoot} contains a readable SKILL.md.`,
+            summary: `Cannot read the installed canonical Silvermoon skill: ${errorMessage(error)}`,
+        };
+    }
+    const paths = [];
+    const invalidPaths = [];
+    for (const relativePath of PERSONAL_SKILL_PATHS) {
+        const path = resolve(home, relativePath);
+        try {
+            const metadata = await filesystem.lstat(path);
+            if (!metadata.isDirectory() && !metadata.isSymbolicLink()) {
+                invalidPaths.push(path);
+                continue;
+            }
+            let target;
+            try {
+                target = await filesystem.realpath(path);
+            }
+            catch (error) {
+                if (errorCode(error) === "ENOENT") {
+                    invalidPaths.push(path);
+                    continue;
+                }
+                throw error;
+            }
+            if (target !== expectedRoot)
+                invalidPaths.push(path);
+            else {
+                await filesystem.readFile(resolve(target, "SKILL.md"), "utf8");
+                paths.push(path);
+            }
+        }
+        catch (error) {
+            if (errorCode(error) !== "ENOENT") {
+                return {
+                    status: "invalid",
+                    expectedRoot,
+                    paths,
+                    summary: `Cannot inspect personal Silvermoon skill ${path}: ${errorMessage(error)}`,
+                };
+            }
+        }
+    }
+    if (invalidPaths.length > 0) {
+        return {
+            status: "mismatched",
+            expectedRoot,
+            paths,
+            invalidPaths,
+            remediation: `Replace the reported personal skill registration with a link to ${expectedRoot}.`,
+        };
+    }
+    if (paths.length === 0) {
+        return {
+            status: "missing",
+            expectedRoot,
+            paths,
+            remediation: `Register ${dirname(expectedRoot)} globally by link in a personal skill discovery path.`,
+        };
+    }
+    return {
+        status: "ready",
+        expectedRoot,
+        paths,
+    };
+}
+export { CACHE_TTL_MS, PERSONAL_SKILL_PATHS };
+//# sourceMappingURL=device-readiness.js.map

package/dist/src/foundation/installation/device-readiness.js.map

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

package/dist/src/foundation/installation/index.d.ts

@@ -0,0 +1,4 @@
+export { classifyRuntimeSource, inspectInstallation, } from "./installation.ts";
+export { CACHE_TTL_MS, inspectPersonalSkill, inspectRuntimeUpdate, PERSONAL_SKILL_PATHS, } from "./device-readiness.ts";
+export { compareSemanticVersions, parseSemanticVersion, } from "./rules.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/installation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/installation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/src/foundation/installation/index.js

@@ -0,0 +1,4 @@
+export { classifyRuntimeSource, inspectInstallation, } from "./installation.js";
+export { CACHE_TTL_MS, inspectPersonalSkill, inspectRuntimeUpdate, PERSONAL_SKILL_PATHS, } from "./device-readiness.js";
+export { compareSemanticVersions, parseSemanticVersion, } from "./rules.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/installation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/installation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}