devworkspace 0.1.0 → 0.2.0

package/dist/integrations/adapters/graphify.js

@@ -0,0 +1,239 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { compareVersions, findPython, findTool } from '../exec.js';
+import { GRAPHIFY_NOTICE, writeThirdPartyNotice } from '../notices.js';
+import { pathExists } from '../../utils/fs.js';
+/**
+ * Graphify. Verified against the published package (graphifyy 0.9.82) and its CLI help on 2026-10-09:
+ *  - PyPI package `graphifyy`, executable `graphify`; README documents pip and pipx (pipx recommended on Windows)
+ *  - `graphify --version` prints "graphify <version>"
+ *  - `graphify install --project` writes .claude/skills/graphify/, appends a graphify section to CLAUDE.md,
+ *    creates .claude/CLAUDE.md and registers PreToolUse hooks (`graphify hook-guard ...`) in .claude/settings.json.
+ *    It merges and is idempotent, but it does change files the user owns, so every run is snapshotted and verified.
+ * uv is not mentioned in the README; `uv tool install` is used because it is the equivalent of pipx for console tools.
+ */
+const EXE = process.platform === 'win32' ? 'graphify.exe' : 'graphify';
+const MIN_PYTHON = '3.10.0';
+async function exists(p) {
+    return pathExists(p);
+}
+async function locate(ctx, deep) {
+    const onPath = await ctx.runner.which('graphify');
+    if (onPath)
+        return { path: onPath, onPath: true };
+    const dirs = [path.join(ctx.home, '.local', 'bin')];
+    if (deep)
+        dirs.push(...(await toolBinDirs(ctx)));
+    for (const d of dirs) {
+        const candidate = path.join(d, ctx.platform === 'win32' ? 'graphify.exe' : EXE);
+        if (await exists(candidate))
+            return { path: candidate, onPath: false };
+    }
+    return { path: null, onPath: false };
+}
+/** Where uv, pipx and `pip --user` put console scripts, asked from the tools themselves (they differ by OS and version). */
+async function toolBinDirs(ctx) {
+    const out = [];
+    const uv = await findTool(ctx.runner, 'uv', ctx.signal);
+    if (uv) {
+        const r = await ctx.runner.run({ command: uv.command, args: ['tool', 'dir', '--bin'], timeoutMs: 10_000, signal: ctx.signal });
+        if (r.ok && r.stdout.trim())
+            out.push(r.stdout.trim().split(/\r?\n/)[0]);
+    }
+    const pipx = await findTool(ctx.runner, 'pipx', ctx.signal);
+    if (pipx) {
+        const r = await ctx.runner.run({ command: pipx.command, args: ['environment', '--value', 'PIPX_BIN_DIR'], timeoutMs: 10_000, signal: ctx.signal });
+        if (r.ok && r.stdout.trim())
+            out.push(r.stdout.trim().split(/\r?\n/)[0]);
+    }
+    const py = await findPython(ctx.runner, ctx.platform, ctx.signal);
+    if (py) {
+        const code = "import sysconfig,os;print(sysconfig.get_path('scripts', os.name + '_user'))";
+        const r = await ctx.runner.run({ command: py.command, args: [...py.args, '-c', code], timeoutMs: 10_000, signal: ctx.signal });
+        if (r.ok && r.stdout.trim())
+            out.push(r.stdout.trim().split(/\r?\n/)[0]);
+    }
+    return out;
+}
+async function readText(p) {
+    try {
+        return await fs.readFile(p, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function pathAdvice(ctx, dir) {
+    const where = dir ? `Add ${dir} to your PATH` : 'Add the folder containing graphify to your PATH';
+    return ctx.platform === 'win32'
+        ? [`${where} (Settings > System > About > Advanced system settings > Environment Variables), or run \`pipx ensurepath\` / \`uv tool update-shell\`, then open a new terminal.`]
+        : [`${where}, or run \`pipx ensurepath\` / \`uv tool update-shell\`, then open a new terminal.`];
+}
+export const graphify = {
+    id: 'graphify',
+    name: 'Graphify',
+    required: true,
+    docsUrl: 'https://github.com/Graphify-Labs/graphify',
+    usage: 'For "where is X / what depends on Y" questions, query the Graphify graph first (graphify query "<question>", graphify path "<A>" "<B>", graphify explain "<concept>") ' +
+        'or use the /graphify skill. The graph is a navigation aid, not a source of truth: confirm in the actual files before relying on it. After editing code, `graphify update .` refreshes it (no LLM cost).',
+    async inspect(ctx, deep) {
+        const loc = await locate(ctx, deep);
+        const projectSkill = await exists(path.join(ctx.root, '.claude', 'skills', 'graphify', 'SKILL.md'));
+        const userSkill = !projectSkill && (await exists(path.join(ctx.home, '.claude', 'skills', 'graphify', 'SKILL.md')));
+        const settings = (await readText(path.join(ctx.root, '.claude', 'settings.json'))) ?? '';
+        const hooks = /graphify\s+hook-guard/.test(settings);
+        const graph = await exists(path.join(ctx.root, 'graphify-out', 'graph.json'));
+        const skillVersion = ((await readText(path.join(ctx.root, '.claude', 'skills', 'graphify', '.graphify_version'))) ?? '').trim() || null;
+        let version = null;
+        let runnable = null;
+        if (deep && loc.path) {
+            const r = await ctx.runner.run({ command: loc.path, args: ['--version'], timeoutMs: 15_000, signal: ctx.signal });
+            const m = /graphify\s+(\S+)/i.exec(r.stdout);
+            runnable = r.ok && !!m;
+            version = m?.[1] ?? null;
+        }
+        const checks = [
+            { name: 'graphify executable', ok: !!loc.path, detail: loc.path ? (loc.onPath ? 'on PATH' : 'found, but not on PATH') : 'not found' },
+        ];
+        if (deep && loc.path)
+            checks.push({ name: 'graphify --version', ok: !!runnable, detail: version ? `graphify ${version}` : 'did not run' });
+        checks.push({ name: 'Claude skill', ok: projectSkill || userSkill, detail: projectSkill ? 'project (.claude/skills/graphify)' : userSkill ? 'user (~/.claude/skills/graphify)' : 'missing' });
+        if (projectSkill && version && skillVersion)
+            checks.push({ name: 'skill matches CLI version', ok: skillVersion === version, detail: `skill ${skillVersion}, CLI ${version}` });
+        const capabilities = { cli: !!loc.path, skill: projectSkill || userSkill, hooks, graphBuilt: graph };
+        const warnings = [];
+        const nextSteps = [];
+        if (!graph)
+            warnings.push('No graph built yet. In Claude Code run `/graphify .` (graph building uses the model, so DevWorkspace does not do it).');
+        const base = { id: 'graphify', name: 'Graphify', required: true, deep, capabilities, checks };
+        const scope = projectSkill ? 'project' : userSkill ? 'user' : null;
+        if (!loc.path && !projectSkill && !userSkill) {
+            nextSteps.push('devworkspace setup --integrations --yes');
+            return { ...base, status: 'NOT_INSTALLED', variant: null, scope: null, version: null, warnings, nextSteps };
+        }
+        if (!loc.path) {
+            warnings.push('The Claude skill/hooks exist but the graphify command is missing, so they cannot work.');
+            nextSteps.push('devworkspace integrations repair --yes');
+            return { ...base, status: 'DEGRADED', variant: 'project skill without CLI', scope, version: null, warnings, nextSteps };
+        }
+        if (deep && runnable === false) {
+            warnings.push('The graphify executable was found but `graphify --version` failed.');
+            nextSteps.push('devworkspace integrations repair --yes');
+            return { ...base, status: 'DEGRADED', variant: 'cli (not runnable)', scope, version, warnings, nextSteps };
+        }
+        if (!projectSkill && !userSkill) {
+            warnings.push('The graphify CLI is installed but its Claude skill is not set up for this project.');
+            nextSteps.push('devworkspace setup --integrations --yes   (runs `graphify install --project`)');
+            return { ...base, status: 'DEGRADED', variant: 'cli without project skill', scope: null, version, warnings, nextSteps };
+        }
+        if (version && skillVersion && compareVersions(version.replace(/[^0-9.]/g, '') || '0.0.0', skillVersion.replace(/[^0-9.]/g, '') || '0.0.0') !== 0) {
+            warnings.push(`The project skill is from graphify ${skillVersion} but the CLI is ${version}.`);
+            nextSteps.push('devworkspace integrations repair --yes');
+            return { ...base, status: 'DEGRADED', variant: 'cli + stale project skill', scope, version, warnings, nextSteps };
+        }
+        if (hooks && !loc.onPath) {
+            warnings.push('Claude Code hooks call `graphify` by name, but it is not on PATH in this terminal, so the hooks would fail.');
+            nextSteps.push(...pathAdvice(ctx, loc.path ? path.dirname(loc.path) : null));
+            return { ...base, status: 'DEGRADED', variant: 'cli + project skill (PATH missing)', scope, version, warnings, nextSteps };
+        }
+        if (!loc.onPath)
+            warnings.push(`graphify is installed but not on PATH. ${pathAdvice(ctx, path.dirname(loc.path))[0]}`);
+        return { ...base, status: deep ? 'VERIFIED' : 'INSTALLED', variant: 'cli + project skill', scope, version, warnings, nextSteps };
+    },
+    async plan(ctx, report) {
+        const protectPaths = ['CLAUDE.md', '.claude/CLAUDE.md', '.claude/settings.json', '.claude/settings.local.json', 'AGENTS.md'];
+        const blockers = [];
+        const notes = [];
+        const steps = [];
+        if (report.status === 'VERIFIED' && !ctx.setup.repair)
+            return { steps, blockers, protectPaths, notes: ['already verified'] };
+        const loc = await locate(ctx, true);
+        const exeRef = { path: loc.path };
+        const scope = ctx.setup.scope;
+        if (!loc.path) {
+            const uv = await findTool(ctx.runner, 'uv', ctx.signal);
+            const pipx = await findTool(ctx.runner, 'pipx', ctx.signal);
+            const py = await findPython(ctx.runner, ctx.platform, ctx.signal);
+            const pyOk = !!py && compareVersions(py.version, MIN_PYTHON) >= 0;
+            const choice = uv
+                ? { command: [uv.command, 'tool', 'install', 'graphifyy'], how: 'uv tool install' }
+                : pipx
+                    ? { command: [pipx.command, 'install', 'graphifyy'], how: 'pipx install' }
+                    : pyOk && py
+                        ? { command: [py.command, ...py.args, '-m', 'pip', 'install', '--user', 'graphifyy'], how: 'pip install --user' }
+                        : null;
+            if (choice && !uv && !pipx)
+                notes.push('uv and pipx were not found; falling back to the documented `pip install --user` (no administrator rights needed).');
+            if (!choice) {
+                if (py && !pyOk)
+                    blockers.push(`Python ${py.version} is too old; graphify needs Python 3.10 or newer.`);
+                blockers.push('No installer found. Graphify is a Python tool: install ONE of these, then re-run setup (nothing else is required):', ctx.platform === 'win32'
+                    ? '  - uv:     winget install --id astral-sh.uv        (or https://docs.astral.sh/uv/getting-started/installation/)'
+                    : '  - uv:     https://docs.astral.sh/uv/getting-started/installation/', '  - Python 3.10+ from https://www.python.org/downloads/ (the Microsoft Store "python" shortcut on Windows is not a real install)', '  - pipx:   https://pipx.pypa.io/stable/installation/');
+                return { steps, blockers, protectPaths, notes };
+            }
+            const { command, how } = choice;
+            const [cmd, ...args] = command;
+            steps.push({
+                id: 'graphify:tool',
+                description: `Install the graphifyy package for your user account (${how}; no administrator rights, nothing system-wide)`,
+                command: command.map((c, i) => (i === 0 ? path.basename(c, path.extname(c)) : c)).join(' '),
+                level: 'machine',
+                async run() {
+                    const r = await ctx.runner.run({ command: cmd, args, cwd: ctx.root, timeoutMs: 600_000, signal: ctx.signal });
+                    if (r.aborted)
+                        return { ok: false, detail: 'cancelled' };
+                    if (r.timedOut)
+                        return { ok: false, detail: 'timed out after 10 minutes (network?)' };
+                    if (!r.ok) {
+                        const text = `${r.stderr}\n${r.stdout}`;
+                        if (/externally[- ]managed/i.test(text))
+                            return { ok: false, detail: 'pip refuses to install into this Python (externally-managed environment). Install pipx or uv instead, then re-run.' };
+                        if (/permission denied|access is denied|EACCES|WinError 5/i.test(text))
+                            return { ok: false, detail: 'permission denied while installing. Run the command yourself from a terminal with the right permissions.' };
+                        const tail = text.split(/\r?\n/).map((l) => l.trim()).filter(Boolean).slice(-3).join(' ');
+                        return { ok: false, detail: (tail || r.error || `exit ${r.code}`).slice(0, 400) };
+                    }
+                    const found = await locate(ctx, true);
+                    if (!found.path)
+                        return { ok: false, detail: 'graphifyy was installed but the graphify executable could not be located. Check the Scripts/bin folder of your Python tool.' };
+                    exeRef.path = found.path;
+                    return { ok: true, detail: found.onPath ? 'installed' : 'installed (not on PATH in this terminal)' };
+                },
+            });
+        }
+        steps.push({
+            id: 'graphify:project-skill',
+            description: scope === 'user'
+                ? 'Install the Graphify skill for your user account (graphify install)'
+                : 'Install the Graphify project skill (graphify install --project): adds .claude/skills/graphify/, appends a graphify section to CLAUDE.md and registers Claude Code hooks in .claude/settings.json (existing content is preserved and verified)',
+            command: scope === 'user' ? 'graphify install' : 'graphify install --project',
+            level: scope === 'user' ? 'user-config' : 'project',
+            async run() {
+                if (!exeRef.path)
+                    return { ok: false, detail: 'the graphify executable is not available' };
+                const r = await ctx.runner.run({ command: exeRef.path, args: scope === 'user' ? ['install'] : ['install', '--project'], cwd: ctx.root, timeoutMs: 120_000, signal: ctx.signal });
+                if (r.aborted)
+                    return { ok: false, detail: 'cancelled' };
+                if (r.timedOut)
+                    return { ok: false, detail: 'timed out after 120 s' };
+                if (!r.ok) {
+                    const tail = `${r.stderr}\n${r.stdout}`.split(/\r?\n/).map((l) => l.trim()).filter(Boolean).slice(-3).join(' ');
+                    return { ok: false, detail: (tail || r.error || `exit ${r.code}`).slice(0, 400) };
+                }
+                return { ok: true, detail: 'project skill installed', restartRequired: true, managedPaths: scope === 'user' ? [] : ['.claude/skills/graphify'] };
+            },
+        });
+        steps.push({
+            id: 'graphify:notice',
+            description: 'Record attribution in .devworkspace/THIRD_PARTY_NOTICES.md',
+            level: 'project',
+            async run() {
+                await writeThirdPartyNotice(ctx.root, GRAPHIFY_NOTICE);
+                return { ok: true };
+            },
+        });
+        return { steps, blockers, protectPaths, notes };
+    },
+};
+//# sourceMappingURL=graphify.js.map

package/dist/integrations/adapters/graphify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphify.js","sourceRoot":"","sources":["../../../src/integrations/adapters/graphify.ts"],"names":[],"mappings":"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","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { compareVersions, findPython, findTool } from '../exec.js';\nimport { GRAPHIFY_NOTICE, writeThirdPartyNotice } from '../notices.js';\nimport type { AdapterContext, Check, IntegrationAdapter, IntegrationReport, PlanResult, PlanStep, StepOutcome } from '../types.js';\nimport { pathExists } from '../../utils/fs.js';\n\n/**\n * Graphify. Verified against the published package (graphifyy 0.9.82) and its CLI help on 2026-10-09:\n *  - PyPI package `graphifyy`, executable `graphify`; README documents pip and pipx (pipx recommended on Windows)\n *  - `graphify --version` prints \"graphify <version>\"\n *  - `graphify install --project` writes .claude/skills/graphify/, appends a graphify section to CLAUDE.md,\n *    creates .claude/CLAUDE.md and registers PreToolUse hooks (`graphify hook-guard ...`) in .claude/settings.json.\n *    It merges and is idempotent, but it does change files the user owns, so every run is snapshotted and verified.\n * uv is not mentioned in the README; `uv tool install` is used because it is the equivalent of pipx for console tools.\n */\n\nconst EXE = process.platform === 'win32' ? 'graphify.exe' : 'graphify';\nconst MIN_PYTHON = '3.10.0';\n\ninterface Located {\n  path: string | null;\n  onPath: boolean;\n}\n\nasync function exists(p: string): Promise<boolean> {\n  return pathExists(p);\n}\n\nasync function locate(ctx: AdapterContext, deep: boolean): Promise<Located> {\n  const onPath = await ctx.runner.which('graphify');\n  if (onPath) return { path: onPath, onPath: true };\n  const dirs = [path.join(ctx.home, '.local', 'bin')];\n  if (deep) dirs.push(...(await toolBinDirs(ctx)));\n  for (const d of dirs) {\n    const candidate = path.join(d, ctx.platform === 'win32' ? 'graphify.exe' : EXE);\n    if (await exists(candidate)) return { path: candidate, onPath: false };\n  }\n  return { path: null, onPath: false };\n}\n\n/** Where uv, pipx and `pip --user` put console scripts, asked from the tools themselves (they differ by OS and version). */\nasync function toolBinDirs(ctx: AdapterContext): Promise<string[]> {\n  const out: string[] = [];\n  const uv = await findTool(ctx.runner, 'uv', ctx.signal);\n  if (uv) {\n    const r = await ctx.runner.run({ command: uv.command, args: ['tool', 'dir', '--bin'], timeoutMs: 10_000, signal: ctx.signal });\n    if (r.ok && r.stdout.trim()) out.push(r.stdout.trim().split(/\\r?\\n/)[0]!);\n  }\n  const pipx = await findTool(ctx.runner, 'pipx', ctx.signal);\n  if (pipx) {\n    const r = await ctx.runner.run({ command: pipx.command, args: ['environment', '--value', 'PIPX_BIN_DIR'], timeoutMs: 10_000, signal: ctx.signal });\n    if (r.ok && r.stdout.trim()) out.push(r.stdout.trim().split(/\\r?\\n/)[0]!);\n  }\n  const py = await findPython(ctx.runner, ctx.platform, ctx.signal);\n  if (py) {\n    const code = \"import sysconfig,os;print(sysconfig.get_path('scripts', os.name + '_user'))\";\n    const r = await ctx.runner.run({ command: py.command, args: [...py.args, '-c', code], timeoutMs: 10_000, signal: ctx.signal });\n    if (r.ok && r.stdout.trim()) out.push(r.stdout.trim().split(/\\r?\\n/)[0]!);\n  }\n  return out;\n}\n\nasync function readText(p: string): Promise<string | null> {\n  try {\n    return await fs.readFile(p, 'utf8');\n  } catch {\n    return null;\n  }\n}\n\nfunction pathAdvice(ctx: AdapterContext, dir: string | null): string[] {\n  const where = dir ? `Add ${dir} to your PATH` : 'Add the folder containing graphify to your PATH';\n  return ctx.platform === 'win32'\n    ? [`${where} (Settings > System > About > Advanced system settings > Environment Variables), or run \\`pipx ensurepath\\` / \\`uv tool update-shell\\`, then open a new terminal.`]\n    : [`${where}, or run \\`pipx ensurepath\\` / \\`uv tool update-shell\\`, then open a new terminal.`];\n}\n\nexport const graphify: IntegrationAdapter = {\n  id: 'graphify',\n  name: 'Graphify',\n  required: true,\n  docsUrl: 'https://github.com/Graphify-Labs/graphify',\n  usage:\n    'For \"where is X / what depends on Y\" questions, query the Graphify graph first (graphify query \"<question>\", graphify path \"<A>\" \"<B>\", graphify explain \"<concept>\") ' +\n    'or use the /graphify skill. The graph is a navigation aid, not a source of truth: confirm in the actual files before relying on it. After editing code, `graphify update .` refreshes it (no LLM cost).',\n\n  async inspect(ctx, deep): Promise<IntegrationReport> {\n    const loc = await locate(ctx, deep);\n    const projectSkill = await exists(path.join(ctx.root, '.claude', 'skills', 'graphify', 'SKILL.md'));\n    const userSkill = !projectSkill && (await exists(path.join(ctx.home, '.claude', 'skills', 'graphify', 'SKILL.md')));\n    const settings = (await readText(path.join(ctx.root, '.claude', 'settings.json'))) ?? '';\n    const hooks = /graphify\\s+hook-guard/.test(settings);\n    const graph = await exists(path.join(ctx.root, 'graphify-out', 'graph.json'));\n    const skillVersion = ((await readText(path.join(ctx.root, '.claude', 'skills', 'graphify', '.graphify_version'))) ?? '').trim() || null;\n\n    let version: string | null = null;\n    let runnable: boolean | null = null;\n    if (deep && loc.path) {\n      const r = await ctx.runner.run({ command: loc.path, args: ['--version'], timeoutMs: 15_000, signal: ctx.signal });\n      const m = /graphify\\s+(\\S+)/i.exec(r.stdout);\n      runnable = r.ok && !!m;\n      version = m?.[1] ?? null;\n    }\n\n    const checks: Check[] = [\n      { name: 'graphify executable', ok: !!loc.path, detail: loc.path ? (loc.onPath ? 'on PATH' : 'found, but not on PATH') : 'not found' },\n    ];\n    if (deep && loc.path) checks.push({ name: 'graphify --version', ok: !!runnable, detail: version ? `graphify ${version}` : 'did not run' });\n    checks.push({ name: 'Claude skill', ok: projectSkill || userSkill, detail: projectSkill ? 'project (.claude/skills/graphify)' : userSkill ? 'user (~/.claude/skills/graphify)' : 'missing' });\n    if (projectSkill && version && skillVersion) checks.push({ name: 'skill matches CLI version', ok: skillVersion === version, detail: `skill ${skillVersion}, CLI ${version}` });\n    const capabilities = { cli: !!loc.path, skill: projectSkill || userSkill, hooks, graphBuilt: graph };\n    const warnings: string[] = [];\n    const nextSteps: string[] = [];\n    if (!graph) warnings.push('No graph built yet. In Claude Code run `/graphify .` (graph building uses the model, so DevWorkspace does not do it).');\n\n    const base = { id: 'graphify', name: 'Graphify', required: true, deep, capabilities, checks } as const;\n    const scope = projectSkill ? 'project' : userSkill ? 'user' : null;\n\n    if (!loc.path && !projectSkill && !userSkill) {\n      nextSteps.push('devworkspace setup --integrations --yes');\n      return { ...base, status: 'NOT_INSTALLED', variant: null, scope: null, version: null, warnings, nextSteps };\n    }\n    if (!loc.path) {\n      warnings.push('The Claude skill/hooks exist but the graphify command is missing, so they cannot work.');\n      nextSteps.push('devworkspace integrations repair --yes');\n      return { ...base, status: 'DEGRADED', variant: 'project skill without CLI', scope, version: null, warnings, nextSteps };\n    }\n    if (deep && runnable === false) {\n      warnings.push('The graphify executable was found but `graphify --version` failed.');\n      nextSteps.push('devworkspace integrations repair --yes');\n      return { ...base, status: 'DEGRADED', variant: 'cli (not runnable)', scope, version, warnings, nextSteps };\n    }\n    if (!projectSkill && !userSkill) {\n      warnings.push('The graphify CLI is installed but its Claude skill is not set up for this project.');\n      nextSteps.push('devworkspace setup --integrations --yes   (runs `graphify install --project`)');\n      return { ...base, status: 'DEGRADED', variant: 'cli without project skill', scope: null, version, warnings, nextSteps };\n    }\n    if (version && skillVersion && compareVersions(version.replace(/[^0-9.]/g, '') || '0.0.0', skillVersion.replace(/[^0-9.]/g, '') || '0.0.0') !== 0) {\n      warnings.push(`The project skill is from graphify ${skillVersion} but the CLI is ${version}.`);\n      nextSteps.push('devworkspace integrations repair --yes');\n      return { ...base, status: 'DEGRADED', variant: 'cli + stale project skill', scope, version, warnings, nextSteps };\n    }\n    if (hooks && !loc.onPath) {\n      warnings.push('Claude Code hooks call `graphify` by name, but it is not on PATH in this terminal, so the hooks would fail.');\n      nextSteps.push(...pathAdvice(ctx, loc.path ? path.dirname(loc.path) : null));\n      return { ...base, status: 'DEGRADED', variant: 'cli + project skill (PATH missing)', scope, version, warnings, nextSteps };\n    }\n    if (!loc.onPath) warnings.push(`graphify is installed but not on PATH. ${pathAdvice(ctx, path.dirname(loc.path))[0]}`);\n    return { ...base, status: deep ? 'VERIFIED' : 'INSTALLED', variant: 'cli + project skill', scope, version, warnings, nextSteps };\n  },\n\n  async plan(ctx, report): Promise<PlanResult> {\n    const protectPaths = ['CLAUDE.md', '.claude/CLAUDE.md', '.claude/settings.json', '.claude/settings.local.json', 'AGENTS.md'];\n    const blockers: string[] = [];\n    const notes: string[] = [];\n    const steps: PlanStep[] = [];\n    if (report.status === 'VERIFIED' && !ctx.setup.repair) return { steps, blockers, protectPaths, notes: ['already verified'] };\n\n    const loc = await locate(ctx, true);\n    const exeRef: { path: string | null } = { path: loc.path };\n    const scope = ctx.setup.scope;\n\n    if (!loc.path) {\n      const uv = await findTool(ctx.runner, 'uv', ctx.signal);\n      const pipx = await findTool(ctx.runner, 'pipx', ctx.signal);\n      const py = await findPython(ctx.runner, ctx.platform, ctx.signal);\n      const pyOk = !!py && compareVersions(py.version, MIN_PYTHON) >= 0;\n      const choice: { command: string[]; how: string } | null = uv\n        ? { command: [uv.command, 'tool', 'install', 'graphifyy'], how: 'uv tool install' }\n        : pipx\n          ? { command: [pipx.command, 'install', 'graphifyy'], how: 'pipx install' }\n          : pyOk && py\n            ? { command: [py.command, ...py.args, '-m', 'pip', 'install', '--user', 'graphifyy'], how: 'pip install --user' }\n            : null;\n      if (choice && !uv && !pipx) notes.push('uv and pipx were not found; falling back to the documented `pip install --user` (no administrator rights needed).');\n      if (!choice) {\n        if (py && !pyOk) blockers.push(`Python ${py.version} is too old; graphify needs Python 3.10 or newer.`);\n        blockers.push(\n          'No installer found. Graphify is a Python tool: install ONE of these, then re-run setup (nothing else is required):',\n          ctx.platform === 'win32'\n            ? '  - uv:     winget install --id astral-sh.uv        (or https://docs.astral.sh/uv/getting-started/installation/)'\n            : '  - uv:     https://docs.astral.sh/uv/getting-started/installation/',\n          '  - Python 3.10+ from https://www.python.org/downloads/ (the Microsoft Store \"python\" shortcut on Windows is not a real install)',\n          '  - pipx:   https://pipx.pypa.io/stable/installation/',\n        );\n        return { steps, blockers, protectPaths, notes };\n      }\n      const { command, how } = choice;\n      const [cmd, ...args] = command;\n      steps.push({\n        id: 'graphify:tool',\n        description: `Install the graphifyy package for your user account (${how}; no administrator rights, nothing system-wide)`,\n        command: command.map((c, i) => (i === 0 ? path.basename(c, path.extname(c)) : c)).join(' '),\n        level: 'machine',\n        async run(): Promise<StepOutcome> {\n          const r = await ctx.runner.run({ command: cmd!, args, cwd: ctx.root, timeoutMs: 600_000, signal: ctx.signal });\n          if (r.aborted) return { ok: false, detail: 'cancelled' };\n          if (r.timedOut) return { ok: false, detail: 'timed out after 10 minutes (network?)' };\n          if (!r.ok) {\n            const text = `${r.stderr}\\n${r.stdout}`;\n            if (/externally[- ]managed/i.test(text)) return { ok: false, detail: 'pip refuses to install into this Python (externally-managed environment). Install pipx or uv instead, then re-run.' };\n            if (/permission denied|access is denied|EACCES|WinError 5/i.test(text)) return { ok: false, detail: 'permission denied while installing. Run the command yourself from a terminal with the right permissions.' };\n            const tail = text.split(/\\r?\\n/).map((l) => l.trim()).filter(Boolean).slice(-3).join(' ');\n            return { ok: false, detail: (tail || r.error || `exit ${r.code}`).slice(0, 400) };\n          }\n          const found = await locate(ctx, true);\n          if (!found.path) return { ok: false, detail: 'graphifyy was installed but the graphify executable could not be located. Check the Scripts/bin folder of your Python tool.' };\n          exeRef.path = found.path;\n          return { ok: true, detail: found.onPath ? 'installed' : 'installed (not on PATH in this terminal)' };\n        },\n      });\n    }\n\n    steps.push({\n      id: 'graphify:project-skill',\n      description:\n        scope === 'user'\n          ? 'Install the Graphify skill for your user account (graphify install)'\n          : 'Install the Graphify project skill (graphify install --project): adds .claude/skills/graphify/, appends a graphify section to CLAUDE.md and registers Claude Code hooks in .claude/settings.json (existing content is preserved and verified)',\n      command: scope === 'user' ? 'graphify install' : 'graphify install --project',\n      level: scope === 'user' ? 'user-config' : 'project',\n      async run(): Promise<StepOutcome> {\n        if (!exeRef.path) return { ok: false, detail: 'the graphify executable is not available' };\n        const r = await ctx.runner.run({ command: exeRef.path, args: scope === 'user' ? ['install'] : ['install', '--project'], cwd: ctx.root, timeoutMs: 120_000, signal: ctx.signal });\n        if (r.aborted) return { ok: false, detail: 'cancelled' };\n        if (r.timedOut) return { ok: false, detail: 'timed out after 120 s' };\n        if (!r.ok) {\n          const tail = `${r.stderr}\\n${r.stdout}`.split(/\\r?\\n/).map((l) => l.trim()).filter(Boolean).slice(-3).join(' ');\n          return { ok: false, detail: (tail || r.error || `exit ${r.code}`).slice(0, 400) };\n        }\n        return { ok: true, detail: 'project skill installed', restartRequired: true, managedPaths: scope === 'user' ? [] : ['.claude/skills/graphify'] };\n      },\n    });\n    steps.push({\n      id: 'graphify:notice',\n      description: 'Record attribution in .devworkspace/THIRD_PARTY_NOTICES.md',\n      level: 'project',\n      async run(): Promise<StepOutcome> {\n        await writeThirdPartyNotice(ctx.root, GRAPHIFY_NOTICE);\n        return { ok: true };\n      },\n    });\n    return { steps, blockers, protectPaths, notes };\n  },\n};\n"]}

package/dist/integrations/adapters/omniroute.d.ts

@@ -0,0 +1,6 @@
+import type { IntegrationAdapter } from '../types.js';
+/**
+ * OmniRoute (model routing) is OPTIONAL and outside DevWorkspace's execution path. It is only observed, never installed:
+ * nothing here requires API keys, model configuration or network access.
+ */
+export declare const omniroute: IntegrationAdapter;

package/dist/integrations/adapters/omniroute.js

@@ -0,0 +1,32 @@
+/**
+ * OmniRoute (model routing) is OPTIONAL and outside DevWorkspace's execution path. It is only observed, never installed:
+ * nothing here requires API keys, model configuration or network access.
+ */
+export const omniroute = {
+    id: 'omniroute',
+    name: 'OmniRoute',
+    required: false,
+    docsUrl: 'https://github.com/diegosouzapw/OmniRoute',
+    usage: 'Not used by DevWorkspace.',
+    async inspect(ctx, deep) {
+        const exe = await ctx.runner.which('omniroute');
+        return {
+            id: 'omniroute',
+            name: 'OmniRoute',
+            required: false,
+            status: exe ? 'INSTALLED' : 'NOT_INSTALLED',
+            variant: exe ? 'executable on PATH (unused)' : null,
+            scope: null,
+            version: null,
+            checks: [{ name: 'omniroute executable', ok: !!exe, detail: exe ? 'found; DevWorkspace does not use it' : 'not found (optional)' }],
+            capabilities: {},
+            warnings: [],
+            nextSteps: [],
+            deep,
+        };
+    },
+    async plan() {
+        return { steps: [], blockers: [], protectPaths: [], notes: ['OmniRoute is optional and is never installed by DevWorkspace.'] };
+    },
+};
+//# sourceMappingURL=omniroute.js.map

package/dist/integrations/adapters/omniroute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omniroute.js","sourceRoot":"","sources":["../../../src/integrations/adapters/omniroute.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAuB;IAC3C,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,2CAA2C;IACpD,KAAK,EAAE,2BAA2B;IAClC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI;QACrB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,OAAO;YACL,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe;YAC3C,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,IAAI;YACnD,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC;YACnI,YAAY,EAAE,EAAE;YAChB,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,EAAE;YACb,IAAI;SACL,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI;QACR,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,+DAA+D,CAAC,EAAE,CAAC;IACjI,CAAC;CACF,CAAC","sourcesContent":["import type { IntegrationAdapter, IntegrationReport } from '../types.js';\n\n/**\n * OmniRoute (model routing) is OPTIONAL and outside DevWorkspace's execution path. It is only observed, never installed:\n * nothing here requires API keys, model configuration or network access.\n */\nexport const omniroute: IntegrationAdapter = {\n  id: 'omniroute',\n  name: 'OmniRoute',\n  required: false,\n  docsUrl: 'https://github.com/diegosouzapw/OmniRoute',\n  usage: 'Not used by DevWorkspace.',\n  async inspect(ctx, deep): Promise<IntegrationReport> {\n    const exe = await ctx.runner.which('omniroute');\n    return {\n      id: 'omniroute',\n      name: 'OmniRoute',\n      required: false,\n      status: exe ? 'INSTALLED' : 'NOT_INSTALLED',\n      variant: exe ? 'executable on PATH (unused)' : null,\n      scope: null,\n      version: null,\n      checks: [{ name: 'omniroute executable', ok: !!exe, detail: exe ? 'found; DevWorkspace does not use it' : 'not found (optional)' }],\n      capabilities: {},\n      warnings: [],\n      nextSteps: [],\n      deep,\n    };\n  },\n  async plan() {\n    return { steps: [], blockers: [], protectPaths: [], notes: ['OmniRoute is optional and is never installed by DevWorkspace.'] };\n  },\n};\n"]}

package/dist/integrations/adapters/pluginSkill.d.ts

@@ -0,0 +1,28 @@
+import { type NativeSpec } from './claudePlugin.js';
+import { type NoticeSource } from '../notices.js';
+import type { AdapterContext, Check, IntegrationAdapter, IntegrationId } from '../types.js';
+export interface PluginSkillConfig {
+    id: IntegrationId;
+    name: string;
+    usage: string;
+    docsUrl: string;
+    native: NativeSpec;
+    /** `owner/repo` for the portable `npx skills add` path. */
+    skillsRepo: string;
+    /** Skill directories whose presence means the portable skills are installed. */
+    coreSkills: string[];
+    notice: NoticeSource;
+    /** Capabilities the native plugin provides that portable skills cannot. */
+    nativeOnly: string[];
+    /** True only when the plugin's own manifest registers lifecycle hooks (verified from its plugin.json). */
+    nativeHooks: boolean;
+    /** Extra check for the native plugin (e.g. hooks need node). */
+    extraNativeChecks?(ctx: AdapterContext): Promise<{
+        checks: Check[];
+        warnings: string[];
+        degraded: boolean;
+    }>;
+    /** Shared supplementary directory expected beside skills (agent-skills ships references/). */
+    referencesDir?: string;
+}
+export declare function createPluginSkillAdapter(cfg: PluginSkillConfig): IntegrationAdapter;

package/dist/integrations/adapters/pluginSkill.js

@@ -0,0 +1,195 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { compareVersions, findClaudeCli } from '../exec.js';
+import { findPlugin, listPlugins, marketplaceRegistered, MIN_PLUGIN_JSON, nativeSteps, pluginId, readDeclared } from './claudePlugin.js';
+import { writeThirdPartyNotice } from '../notices.js';
+import { pathExists } from '../../utils/fs.js';
+const SKILLS_CLI = 'skills';
+async function skillDirs(base) {
+    try {
+        return (await fs.readdir(path.join(base, '.claude', 'skills'), { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+async function fileExists(p) {
+    return pathExists(p);
+}
+export function createPluginSkillAdapter(cfg) {
+    const id = pluginId(cfg.native);
+    async function observe(ctx, deep) {
+        const declared = await readDeclared(ctx, cfg.native);
+        let claude = null;
+        let nativeInstalled = declared.enabled !== null;
+        let nativeScope = declared.enabled;
+        let nativeError = null;
+        let registered = declared.marketplace;
+        let version = null;
+        let listError = null;
+        if (deep) {
+            claude = await findClaudeCli(ctx.runner, ctx.home, ctx.signal);
+            if (claude && compareVersions(claude.version, MIN_PLUGIN_JSON) >= 0) {
+                const l = await listPlugins(ctx, claude);
+                if (l.ok) {
+                    const p = findPlugin(l.plugins, id, ctx.root);
+                    nativeInstalled = !!p && p.enabled;
+                    nativeScope = p ? (p.scope === 'user' ? 'user' : 'project') : null;
+                    version = p?.version ?? null;
+                    if (p && (p.errors?.length ?? 0) > 0)
+                        nativeError = p.errors.join('; ').slice(0, 300);
+                    if (p && !p.enabled)
+                        nativeError = 'the plugin is installed but disabled';
+                    if (!p) {
+                        const reg = await marketplaceRegistered(ctx, claude, cfg.native.marketplaceName);
+                        registered = reg ?? registered;
+                    }
+                    else
+                        registered = true;
+                }
+                else
+                    listError = l.error ?? 'could not list plugins';
+            }
+        }
+        const projectSkills = await skillDirs(ctx.root);
+        const userSkills = await skillDirs(ctx.home);
+        const inProject = cfg.coreSkills.filter((s) => projectSkills.includes(s));
+        const inUser = cfg.coreSkills.filter((s) => userSkills.includes(s));
+        const portablePresent = inProject.length >= inUser.length ? inProject : inUser;
+        const portableScope = portablePresent.length === 0 ? null : inProject.length >= inUser.length ? 'project' : 'user';
+        let refs = true;
+        if (cfg.referencesDir && portablePresent.length > 0) {
+            const base = portableScope === 'user' ? ctx.home : ctx.root;
+            refs = (await fileExists(path.join(base, '.claude', 'skills', cfg.referencesDir))) || (await fileExists(path.join(base, '.claude', cfg.referencesDir))) || (await fileExists(path.join(base, cfg.referencesDir)));
+        }
+        return { claude, nativeInstalled, nativeScope, nativeError, registered, version, listError, portablePresent, portableScope, refs };
+    }
+    return {
+        id: cfg.id,
+        name: cfg.name,
+        required: true,
+        usage: cfg.usage,
+        docsUrl: cfg.docsUrl,
+        async inspect(ctx, deep) {
+            const o = await observe(ctx, deep);
+            const checks = [];
+            const warnings = [];
+            const nextSteps = [];
+            const caps = { skills: false, commands: false, hooks: false };
+            const base = { id: cfg.id, name: cfg.name, required: true, deep };
+            if (deep)
+                checks.push({ name: 'Claude Code CLI', ok: !!o.claude, detail: o.claude ? `v${o.claude.version}` : 'not found (PATH or VS Code extension)' });
+            if (o.listError)
+                warnings.push(`Could not read the plugin list: ${o.listError}`);
+            if (o.nativeInstalled) {
+                checks.push({ name: 'native plugin', ok: !o.nativeError, detail: o.nativeError ?? `${id}${o.nativeScope ? ` (${o.nativeScope} scope)` : ''}` });
+                caps.skills = true;
+                caps.commands = true;
+                let degraded = !!o.nativeError;
+                if (o.nativeError) {
+                    warnings.push(`${cfg.name} plugin problem: ${o.nativeError}`);
+                    nextSteps.push(`claude plugin list   (inspect errors), then: claude plugin enable ${id}`);
+                }
+                const extra = cfg.extraNativeChecks ? await cfg.extraNativeChecks(ctx) : { checks: [], warnings: [], degraded: false };
+                checks.push(...extra.checks);
+                warnings.push(...extra.warnings);
+                caps.hooks = cfg.nativeHooks && !extra.degraded;
+                degraded = degraded || extra.degraded;
+                if (!deep)
+                    warnings.push('Not yet verified against `claude plugin list`; run `devworkspace doctor` or `devworkspace integrations status`.');
+                return { ...base, status: degraded ? 'DEGRADED' : deep ? 'VERIFIED' : 'INSTALLED', variant: 'native plugin', scope: o.nativeScope, version: o.version, checks, capabilities: caps, warnings, nextSteps };
+            }
+            if (o.portablePresent.length > 0) {
+                const complete = o.portablePresent.length === cfg.coreSkills.length;
+                caps.skills = complete;
+                checks.push({ name: 'portable skills', ok: complete, detail: `${o.portablePresent.length}/${cfg.coreSkills.length} core skills found (${o.portableScope} scope)` });
+                if (cfg.referencesDir)
+                    checks.push({ name: 'supplementary references', ok: o.refs, detail: o.refs ? 'found' : `${cfg.referencesDir}/ not installed` });
+                if (!complete) {
+                    const missing = cfg.coreSkills.filter((s) => !o.portablePresent.includes(s));
+                    warnings.push(`Partial installation: missing skills ${missing.join(', ')}.`);
+                    nextSteps.push('devworkspace integrations repair --yes');
+                }
+                if (!o.refs)
+                    warnings.push(`The shared ${cfg.referencesDir}/ checklists are not installed (known limitation of the skills CLI), so skills that point to them have broken references.`);
+                warnings.push(`Portable skills only: ${cfg.nativeOnly.join(', ')} from the native plugin are not available.`);
+                nextSteps.push(`For the full plugin: claude plugin marketplace add ${cfg.native.marketplaceUrl} --scope project, then claude plugin install ${id} --scope project`);
+                return { ...base, status: 'DEGRADED', variant: 'portable skills', scope: o.portableScope, version: null, checks, capabilities: caps, warnings, nextSteps };
+            }
+            checks.push({ name: 'marketplace', ok: o.registered, detail: o.registered ? `${cfg.native.marketplaceName} is registered but the plugin is not installed` : 'not registered' });
+            nextSteps.push('devworkspace setup --integrations --yes');
+            return { ...base, status: 'NOT_INSTALLED', variant: null, scope: null, version: null, checks, capabilities: caps, warnings, nextSteps };
+        },
+        async plan(ctx, report) {
+            const o = await observe(ctx, true);
+            const blockers = [];
+            const notes = [];
+            const protectPaths = ['.claude/settings.json', '.claude/settings.local.json', 'CLAUDE.md', '.claude/CLAUDE.md', 'AGENTS.md'];
+            const steps = [];
+            const scope = ctx.setup.scope;
+            if (report.status === 'VERIFIED' && !ctx.setup.repair)
+                return { steps, blockers, protectPaths, notes: ['already verified'] };
+            if (o.nativeInstalled && !o.nativeError)
+                return { steps, blockers, protectPaths, notes: ['native plugin already installed'] };
+            if (o.claude && compareVersions(o.claude.version, MIN_PLUGIN_JSON) >= 0 && !o.listError) {
+                // marketplace registered but plugin missing -> only the install step
+                steps.push(...nativeSteps(ctx, o.claude, cfg.native, scope, { registered: o.registered }));
+                if (o.nativeError && o.nativeScope) {
+                    notes.push(`The plugin is present but unhealthy (${o.nativeError}); re-running install to repair.`);
+                }
+                return { steps, blockers, protectPaths, notes };
+            }
+            if (o.claude)
+                notes.push(`Claude Code ${o.claude.version} is older than ${MIN_PLUGIN_JSON}, which the plugin commands' --json output needs; using portable skills.`);
+            else
+                notes.push('The Claude Code CLI was not found on PATH or in the VS Code extension; using portable skills instead of the native plugin.');
+            if (o.listError)
+                notes.push(`\`claude plugin list\` failed (${o.listError}); using portable skills.`);
+            // ---- portable skills via the documented Skills CLI ----
+            if (o.portablePresent.length === cfg.coreSkills.length && o.refs)
+                return { steps, blockers, protectPaths, notes: [...notes, 'portable skills already installed'] };
+            const managed = new Set(ctx.prior?.managedPaths ?? []);
+            const baseDir = scope === 'user' ? ctx.home : ctx.root;
+            const existing = await skillDirs(baseDir);
+            const conflicts = cfg.coreSkills.filter((s) => existing.includes(s) && !managed.has(`.claude/skills/${s}`));
+            if (conflicts.length > 0 && o.portablePresent.length < cfg.coreSkills.length) {
+                blockers.push(`Skill folder(s) ${conflicts.join(', ')} already exist in .claude/skills and were not installed by DevWorkspace, so they are treated as yours and will not be overwritten. Rename or remove them, or install the native plugin instead.`);
+                return { steps, blockers, protectPaths, notes };
+            }
+            const args = ['--yes', SKILLS_CLI, 'add', cfg.skillsRepo, '--agent', 'claude-code', '--skill', '*', '--copy', '-y', '--json', ...(scope === 'user' ? ['-g'] : [])];
+            steps.push({
+                id: `${cfg.id}:skills-cli`,
+                description: `Install ${cfg.name} skills from ${cfg.skillsRepo} with the Skills CLI (${scope} scope, copied files, telemetry disabled)`,
+                command: `npx ${args.join(' ')}`,
+                level: 'third-party-code',
+                async run() {
+                    const before = new Set(await skillDirs(baseDir));
+                    const r = await ctx.runner.runNpx(args, { cwd: ctx.root, timeoutMs: 300_000, signal: ctx.signal, env: { DISABLE_TELEMETRY: '1', DO_NOT_TRACK: '1' } });
+                    if (r.aborted)
+                        return { ok: false, detail: 'cancelled' };
+                    if (r.timedOut)
+                        return { ok: false, detail: 'timed out after 300 s (network?)' };
+                    if (!r.ok) {
+                        const tail = `${r.stderr}\n${r.stdout}`.split(/\r?\n/).map((l) => l.trim()).filter(Boolean).slice(-3).join(' ');
+                        return { ok: false, detail: (tail || r.error || `exit ${r.code}`).slice(0, 400) };
+                    }
+                    const after = await skillDirs(baseDir);
+                    const created = after.filter((s) => !before.has(s));
+                    ctx.report({ id: cfg.id, step: `${cfg.id}:skills-cli`, state: 'info', detail: `${created.length} skill folder(s) added` });
+                    return { ok: true, detail: `${created.length} skill folder(s) added`, managedPaths: created.map((s) => `.claude/skills/${s}`) };
+                },
+            });
+            steps.push({
+                id: `${cfg.id}:notice`,
+                description: 'Record third-party license/attribution in .devworkspace/THIRD_PARTY_NOTICES.md',
+                level: 'project',
+                async run() {
+                    await writeThirdPartyNotice(ctx.root, cfg.notice);
+                    return { ok: true };
+                },
+            });
+            return { steps, blockers, protectPaths, notes };
+        },
+    };
+}
+//# sourceMappingURL=pluginSkill.js.map