unity-open-mcp 0.4.0 → 0.5.0

package/dist/running-unity.js

@@ -0,0 +1,387 @@
+// M27 Plan 1 — Cold Safe Mode / dead-bridge detection (process-presence scan).
+//
+// When Unity launches directly into Safe Mode (the bridge assembly fails to
+// compile from a cold start), the bridge's `[InitializeOnLoad]` static
+// constructor never runs, so **no instance lock is ever written**.
+// `classifyInstance(null)` returns `gone` — the same classification as "Unity
+// is not running." Without a positive signal, the MCP server cannot tell the
+// agent to call `read_compile_errors`; it must guess or follow the SKILL's
+// manual `ps`/`grep` workaround.
+//
+// This module ports the Hub's Unity-process scanner
+// (`hub/src-tauri/src/config/running_unity.rs`) into the MCP server so the
+// cold-start case can be detected: when `classifyInstance` is `gone` AND a
+// live Unity process whose command line references this project is found,
+// callers (`bridge_status`, `LiveClient`, the CLI `wait-for-ready`) treat the
+// state as **cold Safe Mode / bridge never compiled** and surface the same
+// recovery path as mid-session `dead_bridge` → `read_compile_errors`.
+//
+// The MCP helper only needs **single-project lookup** (does any Unity process
+// match THIS project path?), not the Hub's full multi-project scan, so the
+// public surface is just `findUnityForProject(projectPath)`.
+//
+// Cross-platform: macOS + Windows (match the Hub). Linux returns null — the
+// Hub also returns an empty list on every other target, so this is no
+// regression. No new runtime deps: `node:child_process`, `node:path`, and the
+// shared `normalizePath` from `instance-discovery.ts` (NOT the Hub's
+// `canonicalize` — case-sensitive paths on macOS/Linux must compare verbatim,
+// and canonicalize would normalize away the very differences that distinguish
+// two projects).
+import { execFileSync } from "node:child_process";
+import { normalizePath } from "./instance-discovery.js";
+/**
+ * Pure `-projectPath` argument parser. Port of Hub
+ * `running_unity.rs#parse_project_path_arg`. Accepts both the space-separated
+ * (`-projectPath <value>`) and equals (`-projectPath=<value>`) forms, plus
+ * the long `--projectPath` variants. Surrounding single or double quotes on
+ * the value are stripped. Returns the first match (matching the rest of the
+ * Hub CLI surface); null when the flag is absent or sits at the end of argv
+ * with no value.
+ *
+ * This is the unit-testable core: the OS-specific scanners feed it an argv
+ * slice extracted from `ps` / PowerShell output.
+ */
+export function parseProjectPathArg(args) {
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const eqForm = stripPrefix(arg, "-projectPath=") ?? stripPrefix(arg, "--projectPath=");
+        if (eqForm !== null) {
+            return unquote(eqForm);
+        }
+        if (arg === "-projectPath" || arg === "--projectPath") {
+            const next = args[i + 1];
+            if (next === undefined)
+                return null; // flag at end with no value
+            return unquote(next);
+        }
+    }
+    return null;
+}
+/** Return `rest` when `value` starts with `prefix`, else null. */
+function stripPrefix(value, prefix) {
+    if (value.startsWith(prefix))
+        return value.slice(prefix.length);
+    return null;
+}
+/**
+ * Strip a single layer of surrounding double or single quotes from a flag
+ * value. Hub-launched Unity passes the path unquoted on macOS (the OS handles
+ * spaces natively) and quoted on Windows when the path contains spaces. We
+ * accept both because the flag may have been supplied by a third-party tool.
+ */
+function unquote(value) {
+    const trimmed = value.trim();
+    if (trimmed.length >= 2) {
+        const first = trimmed.charCodeAt(0);
+        const last = trimmed.charCodeAt(trimmed.length - 1);
+        const dq = '"'.charCodeAt(0);
+        const sq = "'".charCodeAt(0);
+        if ((first === dq && last === dq) || (first === sq && last === sq)) {
+            return trimmed.slice(1, -1);
+        }
+    }
+    return trimmed;
+}
+/**
+ * `true` when the command line's executable basename is `Unity`
+ * (case-sensitive — `unityhub://` URL handlers and the `Unity Hub` GUI do not
+ * match). Windows is filtered by the PowerShell `Name='Unity.exe'` selector
+ * upstream, so this helper is only used for the macOS / `ps` path.
+ *
+ * Extracting the executable path from a `ps` command line is harder than it
+ * looks: the Hub GUI binary lives at
+ * `/Applications/Unity Hub.app/Contents/MacOS/Unity Hub` — i.e. the executable
+ * name itself contains a space, and the parent directory contains the word
+ * "Unity". A naive `split_whitespace().next()` would return `/Applications/Unity`,
+ * which basename-matches `Unity` and (incorrectly) tags the Hub GUI as a
+ * running editor. We solve this by extending the executable prefix past any
+ * tokens that don't look like flags: the Unity editor is virtually always
+ * launched with `-projectPath` (or some other `-flag`), so the first `-flag`
+ * token is a reliable end-of-path marker.
+ */
+export function isUnityCommandLine(commandLine) {
+    const executable = firstExecutablePath(commandLine);
+    const unquoted = trimMatching(executable, '"', "'");
+    const name = basenameSafe(unquoted);
+    return name === "Unity";
+}
+function trimMatching(value, ...chars) {
+    let s = value;
+    while (s.length > 0) {
+        const c = s[0];
+        if (!chars.includes(c))
+            break;
+        // Trim a matching pair only when both ends agree; otherwise stop.
+        if (s.length < 2 || s[s.length - 1] !== c)
+            break;
+        s = s.slice(1, -1);
+    }
+    return s;
+}
+function basenameSafe(path) {
+    if (!path)
+        return "";
+    // `path.basename` mishandles Windows-style paths on a non-Windows host;
+    // split on both separators and take the last non-empty segment.
+    const segments = path.split(/[\\/]/).filter((s) => s.length > 0);
+    return segments.length > 0 ? segments[segments.length - 1] : "";
+}
+/**
+ * Extract the executable path prefix from a `ps` command line. If the line
+ * starts with a `"`, consume the matching closing quote. Otherwise extend the
+ * prefix through any tokens that don't start with `-`, stopping at the first
+ * flag (or end of line). Port of Hub `first_executable_path`.
+ */
+function firstExecutablePath(commandLine) {
+    if (commandLine.length === 0)
+        return commandLine;
+    if (commandLine[0] === '"') {
+        const end = commandLine.indexOf('"', 1);
+        if (end >= 0)
+            return commandLine.slice(0, end + 1);
+    }
+    let pos = 0;
+    for (const token of commandLine.split(/\s+/)) {
+        if (token.startsWith("-") && token !== "--") {
+            return commandLine.slice(0, pos).trimEnd();
+        }
+        // +1 for the whitespace split() consumed.
+        pos += token.length + 1;
+    }
+    return commandLine.trimEnd();
+}
+/**
+ * Naive argv splitter for a `ps`-formatted command line. Honours double and
+ * single quotes and treats backslashes as literal (macOS `ps` output never
+ * escapes them). Port of Hub `split_args`.
+ */
+export function splitArgs(line) {
+    const out = [];
+    let current = "";
+    let inSingle = false;
+    let inDouble = false;
+    for (const ch of line) {
+        if (ch === "'" && !inDouble) {
+            inSingle = !inSingle;
+            continue;
+        }
+        if (ch === '"' && !inSingle) {
+            inDouble = !inDouble;
+            continue;
+        }
+        if (/\s/.test(ch) && !inSingle && !inDouble) {
+            if (current.length > 0) {
+                out.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += ch;
+    }
+    if (current.length > 0)
+        out.push(current);
+    return out;
+}
+/**
+ * Windows argv splitter. Same rules as {@link splitArgs} but treats `/` and
+ * `\` as ordinary characters (Windows paths use both). Honours `\"` as an
+ * embedded literal quote inside a double-quoted string, matching the
+ * `CommandLine` quoting convention emitted by `Get-CimInstance Win32_Process`.
+ * Port of Hub `split_args_windows`.
+ */
+export function splitArgsWindows(line) {
+    const out = [];
+    let current = "";
+    let inDouble = false;
+    const chars = Array.from(line);
+    for (let i = 0; i < chars.length; i++) {
+        const ch = chars[i];
+        if (inDouble && ch === "\\") {
+            const next = chars[i + 1];
+            if (next === '"' || next === "\\") {
+                current += next;
+                i += 1;
+                continue;
+            }
+        }
+        if (ch === '"') {
+            inDouble = !inDouble;
+            continue;
+        }
+        if (/\s/.test(ch) && !inDouble) {
+            if (current.length > 0) {
+                out.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += ch;
+    }
+    if (current.length > 0)
+        out.push(current);
+    return out;
+}
+/**
+ * Parse macOS `ps -axww -o pid=,command=` output. One line per process: the
+ * PID is the first whitespace-delimited token, the rest is the full command.
+ * Lines whose executable basename is not `Unity` are skipped (rejects the Hub
+ * GUI, `unityhub://` URL handlers, unrelated tools). Port of Hub
+ * `parse_ps_output`.
+ */
+export function parsePsOutput(stdout) {
+    const out = [];
+    for (const line of stdout.split(/\r?\n/)) {
+        const trimmed = line.replace(/^\s+/, "");
+        if (trimmed.length === 0)
+            continue;
+        const m = trimmed.match(/^(\S+)\s+(.*)$/);
+        if (!m)
+            continue;
+        const pidStr = m[1];
+        const rest = m[2].replace(/^\s+/, "");
+        const pid = Number.parseInt(pidStr, 10);
+        if (!Number.isInteger(pid) || pid <= 0)
+            continue;
+        if (!isUnityCommandLine(rest))
+            continue;
+        const projectPath = parseProjectPathArg(splitArgs(rest));
+        out.push({
+            pid,
+            projectPath: projectPath !== null ? normalizePath(projectPath) : null,
+        });
+    }
+    return out;
+}
+/**
+ * Parse the `PID|commandline` lines emitted by the PowerShell scan.
+ * `CommandLine` is `null` for system-owned processes; we record the PID
+ * without a project path so the caller can still do its PID-only fallback.
+ * Port of Hub `parse_powershell_lines`.
+ */
+export function parsePowerShellLines(stdout) {
+    const out = [];
+    for (const line of stdout.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            continue;
+        const bar = trimmed.indexOf("|");
+        if (bar < 0)
+            continue;
+        const pidStr = trimmed.slice(0, bar);
+        const rest = trimmed.slice(bar + 1);
+        const pid = Number.parseInt(pidStr, 10);
+        if (!Number.isInteger(pid) || pid <= 0)
+            continue;
+        const projectPath = rest.length === 0 || rest === "null"
+            ? null
+            : parseProjectPathArg(splitArgsWindows(rest));
+        out.push({
+            pid,
+            projectPath: projectPath !== null ? normalizePath(projectPath) : null,
+        });
+    }
+    return out;
+}
+/** macOS `ps -axww -o pid=,command=` scanner. Port of Hub `scan_macos`. */
+function scanMacos() {
+    let stdout;
+    try {
+        stdout = execFileSync("ps", ["-axww", "-o", "pid=,command="], {
+            encoding: "utf8",
+        });
+    }
+    catch {
+        // ps missing or failed (non-macOS CI container without procps). Return
+        // empty — the cold-Safe-Mode branch then falls through to "stopped", the
+        // pre-feature behavior, so no regression.
+        return [];
+    }
+    return parsePsOutput(stdout);
+}
+/** Windows PowerShell `Get-CimInstance Win32_Process` scanner. Port of Hub
+ *  `scan_windows`. */
+function scanWindows() {
+    const script = "Get-CimInstance Win32_Process -Filter \"Name='Unity.exe'\" | " +
+        "ForEach-Object { Write-Output ($_.ProcessId.ToString() + '|' + $_.CommandLine) }";
+    let stdout;
+    try {
+        stdout = execFileSync("powershell", ["-NoProfile", "-NonInteractive", "-Command", script], { encoding: "utf8", windowsHide: true });
+    }
+    catch {
+        // PowerShell missing or failed. Return empty.
+        return [];
+    }
+    return parsePowerShellLines(stdout);
+}
+/** Real scanner — dispatches to the OS-native command. Linux/other → empty. */
+const realScanner = {
+    scan() {
+        const platform = process.platform;
+        if (platform === "darwin")
+            return scanMacos();
+        if (platform === "win32")
+            return scanWindows();
+        return []; // Linux + others: no regression (Hub matches).
+    },
+};
+// Mutable binding so tests can swap in a fake without threading a dependency
+// through every caller. Default is the real OS scanner.
+let currentScanner = realScanner;
+/** Read the active scanner. Callers (`findUnityForProject`) use this. */
+export function getUnityProcessScanner() {
+    return currentScanner;
+}
+/**
+ * Install a fake scanner for tests. Returns a restore function that re-binds
+ * the previous scanner (so concurrent test files don't leak state). Production
+ * code MUST NOT call this.
+ */
+export function setUnityProcessScannerForTest(fake) {
+    const prev = currentScanner;
+    currentScanner = fake ?? realScanner;
+    return () => {
+        currentScanner = prev;
+    };
+}
+/**
+ * Scan for a live Unity process whose command line references `projectPath`.
+ *
+ * Returns `{ pid }` for the first match (by PID), or null when no Unity
+ * process matches. Path comparison uses {@link normalizePath} from
+ * `instance-discovery.ts` (case-sensitive on macOS/Linux — `canonicalize`
+ * would normalize away the very differences that distinguish two projects,
+ * and the Hub does the same on its side).
+ *
+ * Also matches when Unity is running WITHOUT `-projectPath` (bare editor
+ * launch). The Hub covers this via `lastLaunchPid`; the MCP server has no
+ * persisted launch PID, so this is a known false negative we accept — the
+ * scan simply returns null and the caller falls back to its pre-feature
+ * behavior. Documented in tests.
+ *
+ * Never throws: any scanner failure (ps missing, PowerShell slow, parse
+ * error) returns null. A failed scan must not mask the underlying offline
+ * state.
+ *
+ * @param projectPath absolute Unity project root to match against.
+ */
+export function findUnityForProject(projectPath) {
+    if (!projectPath)
+        return null;
+    const target = normalizePath(projectPath);
+    if (target.length === 0)
+        return null;
+    let found = [];
+    try {
+        found = getUnityProcessScanner().scan();
+    }
+    catch {
+        return null;
+    }
+    for (const proc of found) {
+        if (proc.projectPath !== null && normalizePath(proc.projectPath) === target) {
+            return { pid: proc.pid };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=running-unity.js.map

package/dist/running-unity.js.map

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

package/dist/skill/client-paths.d.ts

@@ -19,6 +19,28 @@ export declare const BUNDLED_MANIFEST: ClientPathsManifest;
  * process).
  */
 export declare function loadClientPathsManifest(): ClientPathsManifest;
+/**
+ * Absolute path to the template skill file
+ * (`<toolkitRoot>/<manifest.templateRelativePath>`), resolved from the
+ * same root discovery that loads `client-paths.json`. Returns `null`
+ * when the toolkit root cannot be found (bundled-fallback / standalone
+ * `mcp-server/` install) so callers can degrade gracefully instead of
+ * guessing a path. Never throws.
+ *
+ * Used by the skill generator to merge the template workflow prose
+ * with the project-specific inventory (the template is the source of
+ * truth for the workflow playbook).
+ */
+export declare function resolveTemplateSkillPath(): string | null;
+/**
+ * @internal Test-only cache reset. The manifest resolution is cached
+ * for process lifetime (it is immutable in production, where the env
+ * override is set before the process starts). Tests that mutate
+ * `UNITY_OPEN_MCP_TOOLKIT_ROOT` after a prior test already warmed the
+ * cache need this to observe the override. Do not call from runtime
+ * code.
+ */
+export declare function _clearClientPathsCacheForTests(): void;
 /**
  * Project-relative skill path for a client key
  * (`cursor` / `claude` / `opencode` / `agents`). Throws for unknown

package/dist/skill/client-paths.js

@@ -34,15 +34,37 @@ export const BUNDLED_MANIFEST = {
         claude: { relativePath: ".claude/skills/unity-open-mcp/SKILL.md" },
         opencode: { relativePath: ".opencode/skills/unity-open-mcp/SKILL.md" },
         agents: { relativePath: ".agents/skills/unity-open-mcp/SKILL.md" },
+        cline: { relativePath: ".cline/skills/unity-open-mcp/SKILL.md" },
+        gemini: { relativePath: ".gemini/skills/unity-open-mcp/SKILL.md" },
+        kilocode: { relativePath: ".kilocode/skills/unity-open-mcp/SKILL.md" },
+        roo: { relativePath: ".roo/skills/unity-open-mcp/SKILL.md" },
+        agent: { relativePath: ".agent/skills/unity-open-mcp/SKILL.md" },
+        junie: { relativePath: ".junie/skills/unity-open-mcp/SKILL.md" },
+        vscode: { relativePath: ".vscode/skills/unity-open-mcp/SKILL.md" },
+        vs: { relativePath: ".vs/skills/unity-open-mcp/SKILL.md" },
+        github: { relativePath: ".github/skills/unity-open-mcp/SKILL.md" },
     },
     mcpClientMapping: {
         cursor: ["cursor"],
+        "cursor-project": ["cursor"],
         "claude-desktop": ["claude"],
         "claude-code": ["claude"],
         "opencode-global": ["opencode"],
         "opencode-project": ["opencode"],
         "zcode-global": ["agents"],
         "zcode-project": ["agents"],
+        zoocode: ["roo"],
+        cline: ["cline"],
+        codex: ["agents"],
+        gemini: ["gemini"],
+        "github-copilot-cli": ["claude"],
+        "kilo-code": ["kilocode"],
+        rider: ["junie"],
+        "unity-ai": [],
+        "vscode-copilot": ["vscode"],
+        "vs-copilot": ["vs"],
+        antigravity: ["agent"],
+        custom: ["cursor", "claude", "opencode", "agents"],
         manual: ["cursor", "claude", "opencode", "agents"],
     },
 };
@@ -71,13 +93,13 @@ function tryReadManifest(path) {
         return null;
     }
 }
-function resolveManifest() {
+function resolveManifestWithRoot() {
     // 1. Explicit env override.
     const envRoot = process.env.UNITY_OPEN_MCP_TOOLKIT_ROOT?.trim();
     if (envRoot) {
         const fromEnv = tryReadManifest(join(envRoot, MANIFEST_REL));
         if (fromEnv)
-            return fromEnv;
+            return { manifest: fromEnv, toolkitRoot: envRoot };
     }
     // 2. Walk up from this module's directory looking for the toolkit
     //    root (i.e. a parent dir containing `skills/client-paths.json`).
@@ -86,14 +108,17 @@ function resolveManifest() {
         const candidate = join(dir, MANIFEST_REL);
         const m = tryReadManifest(candidate);
         if (m)
-            return m;
+            return { manifest: m, toolkitRoot: dir };
         const parent = dirname(dir);
         if (parent === dir)
             break;
         dir = parent;
     }
     // 3. Bundled fallback (validated against the manifest by tests).
-    return BUNDLED_MANIFEST;
+    return { manifest: BUNDLED_MANIFEST, toolkitRoot: null };
+}
+function resolveManifest() {
+    return resolveManifestWithRoot().manifest;
 }
 let cached = null;
 /**
@@ -102,11 +127,47 @@ let cached = null;
  * process).
  */
 export function loadClientPathsManifest() {
+    return getResolvedManifest().manifest;
+}
+/**
+ * Internal: the resolved manifest + the toolkit root it was loaded
+ * from. Cached after the first call.
+ */
+function getResolvedManifest() {
     if (cached)
         return cached;
-    cached = resolveManifest();
+    cached = resolveManifestWithRoot();
     return cached;
 }
+/**
+ * Absolute path to the template skill file
+ * (`<toolkitRoot>/<manifest.templateRelativePath>`), resolved from the
+ * same root discovery that loads `client-paths.json`. Returns `null`
+ * when the toolkit root cannot be found (bundled-fallback / standalone
+ * `mcp-server/` install) so callers can degrade gracefully instead of
+ * guessing a path. Never throws.
+ *
+ * Used by the skill generator to merge the template workflow prose
+ * with the project-specific inventory (the template is the source of
+ * truth for the workflow playbook).
+ */
+export function resolveTemplateSkillPath() {
+    const { manifest, toolkitRoot } = getResolvedManifest();
+    if (!toolkitRoot)
+        return null;
+    return join(toolkitRoot, manifest.templateRelativePath);
+}
+/**
+ * @internal Test-only cache reset. The manifest resolution is cached
+ * for process lifetime (it is immutable in production, where the env
+ * override is set before the process starts). Tests that mutate
+ * `UNITY_OPEN_MCP_TOOLKIT_ROOT` after a prior test already warmed the
+ * cache need this to observe the override. Do not call from runtime
+ * code.
+ */
+export function _clearClientPathsCacheForTests() {
+    cached = null;
+}
 /**
  * Project-relative skill path for a client key
  * (`cursor` / `claude` / `opencode` / `agents`). Throws for unknown

package/dist/skill/client-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-paths.js","sourceRoot":"","sources":["../../src/skill/client-paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client-paths.js","sourceRoot":"","sources":["../../src/skill/client-paths.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,qDAAqD;AACrD,+BAA+B;AAC/B,mEAAmE;AACnE,mEAAmE;AACnE,kEAAkE;AAClE,mEAAmE;AACnE,6BAA6B;AAC7B,EAAE;AACF,uBAAuB;AACvB,gEAAgE;AAChE,mDAAmD;AACnD,uDAAuD;AACvD,mEAAmE;AACnE,oDAAoD;AACpD,oEAAoE;AACpE,4DAA4D;AAC5D,qEAAqE;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAazC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB;IACnD,OAAO,EAAE,gBAAgB;IACzB,oBAAoB,EAAE,gCAAgC;IACtD,OAAO,EAAE;QACP,MAAM,EAAE,EAAE,YAAY,EAAE,wCAAwC,EAAE;QAClE,MAAM,EAAE,EAAE,YAAY,EAAE,wCAAwC,EAAE;QAClE,QAAQ,EAAE,EAAE,YAAY,EAAE,0CAA0C,EAAE;QACtE,MAAM,EAAE,EAAE,YAAY,EAAE,wCAAwC,EAAE;QAClE,KAAK,EAAE,EAAE,YAAY,EAAE,uCAAuC,EAAE;QAChE,MAAM,EAAE,EAAE,YAAY,EAAE,wCAAwC,EAAE;QAClE,QAAQ,EAAE,EAAE,YAAY,EAAE,0CAA0C,EAAE;QACtE,GAAG,EAAE,EAAE,YAAY,EAAE,qCAAqC,EAAE;QAC5D,KAAK,EAAE,EAAE,YAAY,EAAE,uCAAuC,EAAE;QAChE,KAAK,EAAE,EAAE,YAAY,EAAE,uCAAuC,EAAE;QAChE,MAAM,EAAE,EAAE,YAAY,EAAE,wCAAwC,EAAE;QAClE,EAAE,EAAE,EAAE,YAAY,EAAE,oCAAoC,EAAE;QAC1D,MAAM,EAAE,EAAE,YAAY,EAAE,wCAAwC,EAAE;KACnE;IACD,gBAAgB,EAAE;QAChB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,gBAAgB,EAAE,CAAC,QAAQ,CAAC;QAC5B,gBAAgB,EAAE,CAAC,QAAQ,CAAC;QAC5B,aAAa,EAAE,CAAC,QAAQ,CAAC;QACzB,iBAAiB,EAAE,CAAC,UAAU,CAAC;QAC/B,kBAAkB,EAAE,CAAC,UAAU,CAAC;QAChC,cAAc,EAAE,CAAC,QAAQ,CAAC;QAC1B,eAAe,EAAE,CAAC,QAAQ,CAAC;QAC3B,OAAO,EAAE,CAAC,KAAK,CAAC;QAChB,KAAK,EAAE,CAAC,OAAO,CAAC;QAChB,KAAK,EAAE,CAAC,QAAQ,CAAC;QACjB,MAAM,EAAE,CAAC,QAAQ,CAAC;QAClB,oBAAoB,EAAE,CAAC,QAAQ,CAAC;QAChC,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,KAAK,EAAE,CAAC,OAAO,CAAC;QAChB,UAAU,EAAE,EAAE;QACd,gBAAgB,EAAE,CAAC,QAAQ,CAAC;QAC5B,YAAY,EAAE,CAAC,IAAI,CAAC;QACpB,WAAW,EAAE,CAAC,OAAO,CAAC;QACtB,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC;QAClD,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC;KACnD;CACF,CAAC;AAEF,SAAS,OAAO;IACd,mEAAmE;IACnE,2BAA2B;IAC3B,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACvD,OAAO,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiC,CAAC;QAC/D,IACE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;YAClC,OAAO,MAAM,CAAC,oBAAoB,KAAK,QAAQ;YAC/C,MAAM,CAAC,OAAO;YACd,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;YAClC,MAAM,CAAC,gBAAgB;YACvB,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ,EAC3C,CAAC;YACD,OAAO,MAA6B,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAYD,SAAS,uBAAuB;IAC9B,4BAA4B;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,CAAC;IAChE,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;QAC7D,IAAI,OAAO;YAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAClE,CAAC;IACD,kEAAkE;IAClE,qEAAqE;IACrE,IAAI,GAAG,GAAG,OAAO,EAAE,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,iEAAiE;IACjE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,uBAAuB,EAAE,CAAC,QAAQ,CAAC;AAC5C,CAAC;AAED,IAAI,MAAM,GAA4B,IAAI,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,mBAAmB,EAAE,CAAC,QAAQ,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB;IAC1B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACxD,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B;IAC5C,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,MAAM,QAAQ,GAAG,uBAAuB,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,6BAA6B,SAAS,kBAAkB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,YAAY,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/skill/generate-skill.d.ts

@@ -29,10 +29,49 @@ export interface GenerateSkillResult {
     project: ProjectState;
     written: SkillWriteTarget[];
 }
+export interface GenerateSkillOptions {
+    write?: boolean;
+    clients?: string[];
+    /**
+     * When `true` (default), the generated skill composes the template
+     * workflow playbook (verbatim, the single source of truth for agent
+     * guidance) with the project-specific inventory section. When
+     * `false`, or when the template cannot be located, the generator
+     * falls back to its standalone full-inventory output.
+     */
+    includeWorkflow?: boolean;
+}
 export declare function readProjectState(projectRoot: string): Promise<ProjectState>;
 export declare function generateSkillMarkdown(state: ProjectState, caps: CapabilitiesResult): string;
 export declare function writeSkillToClients(projectRoot: string, content: string, clients: string[]): Promise<SkillWriteTarget[]>;
-export declare function generateSkill(projectRoot: string, caps: CapabilitiesResult, options?: {
-    write?: boolean;
-    clients?: string[];
-}): Promise<GenerateSkillResult>;
+/**
+ * Read the template workflow playbook from disk. Returns the template
+ * text (normalized to end with a single trailing newline), or `null`
+ * when the template cannot be located or read — the composer then
+ * degrades to the standalone full-inventory output. Never throws.
+ */
+export declare function readTemplateWorkflow(): Promise<string | null>;
+/**
+ * Compose the final skill markdown from the template playbook + the
+ * project inventory.
+ *
+ * - When `template` is non-null and `includeWorkflow !== false`: the
+ *   template is emitted verbatim (the authoritative workflow prose),
+ *   followed by a `---` separator and a `# Project inventory —
+ *   <projectName>` section carrying the project-specific blocks. Both
+ *   the template's heading and the project-name heading appear in the
+ *   output.
+ * - When `template` is null (standalone install, template missing) or
+ *   `includeWorkflow === false`: falls back to `generateSkillMarkdown`
+ *   (the full standalone inventory, including its own workflow summary).
+ */
+export declare function composeSkillMarkdown(state: ProjectState, caps: CapabilitiesResult, template: string | null, options?: {
+    includeWorkflow?: boolean;
+}): string;
+export declare function generateSkill(projectRoot: string, caps: CapabilitiesResult, options?: GenerateSkillOptions): Promise<GenerateSkillResult>;
+/**
+ * Truncate a skill preview for embedding in a JSON envelope (Hub /
+ * CLI echo). The full skill is always written to disk when write=true;
+ * this only bounds the in-response copy.
+ */
+export declare function truncateForPreview(skill: string): string;