@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/adapters/git/system-git.js

@@ -0,0 +1,170 @@
+// Git transport and checkout operations with structured failure recovery.
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { shellLine } from '../../domain/shell.js';
+import { parseAheadBehind, parsePorcelainStatus, parseRemotes, } from '../../domain/workspace/state.js';
+export class SystemGit {
+    process;
+    constructor(process) {
+        this.process = process;
+    }
+    async clone(request) {
+        const vector = [
+            'clone',
+            '--quiet',
+            '--origin',
+            'upstream',
+            '--branch',
+            request.branch,
+            request.upstream,
+            request.dir,
+        ];
+        const result = await this.git(vector);
+        if (result.code !== 0) {
+            throw new DevkitError(gitFailureCategory(result.stderr), 'GIT_CLONE_FAILED', `git clone ${request.upstream} failed: ${lastLine(result.stderr)}`, {
+                hint: gitFailureHint(result.stderr),
+                nextSteps: [
+                    shellLine(['git', 'ls-remote', '--heads', request.upstream, request.branch]),
+                    shellLine(['git', ...vector]),
+                ],
+            });
+        }
+        if (request.origin !== undefined)
+            await this.addRemote(request.dir, 'origin', request.origin);
+    }
+    async fetch(dir, remote) {
+        const result = await this.git(['-C', dir, 'fetch', '--quiet', '--prune', remote]);
+        if (result.code !== 0) {
+            throw new DevkitError(gitFailureCategory(result.stderr), 'GIT_FETCH_FAILED', `git fetch ${remote} in ${dir} failed: ${lastLine(result.stderr)}`, {
+                hint: 'The remote may be unreachable, or the remote name may be wrong.',
+                nextSteps: ['fx status', `git -C ${dir} remote -v`],
+            });
+        }
+    }
+    async fastForward(dir, remote, branch) {
+        const state = await this.status(dir);
+        const onBranch = state.branch === branch && !state.dirty;
+        const ref = onBranch ? 'HEAD' : branch;
+        const before = await this.revParse(dir, ref);
+        const result = onBranch
+            ? await this.git(['-C', dir, 'merge', '--ff-only', '--quiet', `${remote}/${branch}`])
+            : await this.git(['-C', dir, 'fetch', '--quiet', remote, `${branch}:${branch}`]);
+        if (result.code !== 0) {
+            if (/not possible to fast-forward|non-fast-forward/i.test(result.stderr))
+                return 'diverged';
+            throw new DevkitError(gitFailureCategory(result.stderr), 'GIT_FAST_FORWARD_FAILED', `Could not update ${branch}: ${lastLine(result.stderr)}`, {
+                hint: gitFailureHint(result.stderr),
+                nextSteps: [
+                    shellLine(['git', '-C', dir, 'status']),
+                    shellLine(['git', '-C', dir, 'ls-remote', '--heads', remote, branch]),
+                ],
+            });
+        }
+        const after = await this.revParse(dir, ref);
+        return before === after ? 'up_to_date' : 'updated';
+    }
+    async status(dir, compareTo) {
+        const result = await this.git([
+            '-C',
+            dir,
+            'status',
+            '--porcelain=v2',
+            '--branch',
+            '--untracked-files=all',
+        ]);
+        if (result.code !== 0) {
+            throw new DevkitError('conflict', 'NOT_A_CHECKOUT', `${dir} is not a git checkout: ${lastLine(result.stderr)}`, {
+                nextSteps: ['fx status'],
+            });
+        }
+        const state = parsePorcelainStatus(result.stdout);
+        if (compareTo === undefined)
+            return state;
+        const counted = await this.git([
+            '-C',
+            dir,
+            'rev-list',
+            '--left-right',
+            '--count',
+            `HEAD...${compareTo}`,
+        ]);
+        return counted.code === 0 ? { ...state, ...parseAheadBehind(counted.stdout) } : state;
+    }
+    async toplevel(dir) {
+        const result = await this.git(['-C', dir, 'rev-parse', '--show-toplevel']);
+        return result.code === 0 ? path.normalize(result.stdout.trim()) : undefined;
+    }
+    async remotes(dir, signal) {
+        const result = await this.git(['-C', dir, 'remote', '-v'], { signal });
+        return result.code === 0 ? parseRemotes(result.stdout) : {};
+    }
+    async remoteHead(dir, remote, signal) {
+        const ref = `refs/remotes/${remote}/HEAD`;
+        const result = await this.git(['-C', dir, 'symbolic-ref', '--short', ref], { signal });
+        if (result.code !== 0)
+            return undefined;
+        return result.stdout.trim().replace(new RegExp(`^${remote}/`), '') || undefined;
+    }
+    async addRemote(dir, name, url) {
+        const result = await this.git(['-C', dir, 'remote', 'add', name, url]);
+        if (result.code !== 0) {
+            throw new DevkitError('conflict', 'GIT_REMOTE_ADD_FAILED', `Could not add remote ${name} in ${dir}: ${lastLine(result.stderr)}`, {
+                nextSteps: [`git -C ${dir} remote -v`],
+            });
+        }
+    }
+    async askRemoteHead(dir, remote, timeoutMs, signal) {
+        const ask = (symref) => this.git(['-C', dir, 'ls-remote', '--quiet', ...(symref ? ['--symref'] : []), remote, 'HEAD'], { timeoutMs, signal });
+        // A git too old for --symref answers with usage (129); the branch is then unknown.
+        let result = await ask(true);
+        if (result.code === 129)
+            result = await ask(false);
+        const sha = /^([0-9a-f]{40,64})\tHEAD$/m.exec(result.stdout)?.[1];
+        if (result.code !== 0 || sha === undefined)
+            return undefined;
+        return { sha, branch: /^ref: refs\/heads\/(\S+)\tHEAD$/m.exec(result.stdout)?.[1] };
+    }
+    sha(dir, ref, signal) {
+        return this.revParse(dir, ref, signal);
+    }
+    async revParse(dir, ref, signal) {
+        const result = await this.git(['-C', dir, 'rev-parse', '--verify', '--quiet', ref], { signal });
+        return result.code === 0 ? result.stdout.trim() : undefined;
+    }
+    async git(args, options = {}) {
+        const result = await this.process.run(['git', ...args], {
+            ...options,
+            env: { ...options.env, LC_ALL: 'C' },
+        });
+        if (result.code === 127) {
+            throw new DevkitError('config', 'TOOL_MISSING', 'git is not installed or not on PATH', {
+                nextSteps: ['fx can git'],
+            });
+        }
+        return result;
+    }
+}
+function lastLine(text) {
+    const lines = text.trim().split('\n');
+    return lines[lines.length - 1] ?? '';
+}
+function gitFailureCategory(stderr) {
+    if (/remote branch .*not found|couldn't find remote ref|not something we can merge|repository .* does not exist/i.test(stderr))
+        return 'not_found';
+    if (/permission denied|authentication failed|could not read username|access denied/i.test(stderr))
+        return 'auth';
+    if (/could not resolve|unable to access|connection|timed out|network|could not read from remote/i.test(stderr))
+        return 'network';
+    return 'conflict';
+}
+function gitFailureHint(stderr) {
+    const category = gitFailureCategory(stderr);
+    if (category === 'not_found')
+        return 'Verify the configured branch still exists on the remote.';
+    if (category === 'auth')
+        return 'Verify Git transport credentials and repository access; API login is separate.';
+    if (category === 'network')
+        return 'Check Git transport connectivity and retry after it is restored.';
+    return 'Inspect Git diagnostics and local checkout state before retrying; no divergence was inferred.';
+}
+//# sourceMappingURL=system-git.js.map

package/dist/adapters/git/system-git.js.map

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

package/dist/adapters/im/lark/provider.js

@@ -0,0 +1,26 @@
+// Lark user chat discovery is verified with one read-only metadata query.
+// The entry remains data; fx never reads or sends messages itself.
+const CHATS = ['im', '+chat-list', '--as', 'user', '--types', 'group'];
+export const larkProvider = {
+    id: 'lark',
+    capability: 'im',
+    reference: true,
+    tools: ['lark-cli'],
+    vars: [],
+    recipes: [
+        {
+            id: 'access',
+            tool: 'lark-cli',
+            perEnv: false,
+            kind: 'manual',
+            title: 'Authorize Lark user chat discovery',
+            instructions: 'Use the Lark Skill to authorize the user identity and the scopes reported by chat discovery; do not silently switch to a bot.',
+            verify: { command: [...CHATS, '--page-size', '1', '--format', 'json'] },
+        },
+    ],
+    create: () => ({
+        label: 'Lark group chats for the user identity',
+        command: ['lark-cli', ...CHATS, '--page-size', '20', '--format', 'json'],
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/im/lark/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/im/lark/provider.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,mEAAmE;AAKnE,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,YAAY,GAAmC;IAC1D,EAAE,EAAE,MAAM;IACV,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC,UAAU,CAAC;IACnB,IAAI,EAAE,EAAE;IACR,OAAO,EAAE;QACP;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,oCAAoC;YAC3C,YAAY,EACV,+HAA+H;YACjI,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE;SACxE;KACF;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,wCAAwC;QAC/C,OAAO,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC;KACzE,CAAC;CACH,CAAC"}

package/dist/adapters/im/wecom/provider.js

@@ -0,0 +1,29 @@
+// WeCom readiness checks the response code of a read-only session query.
+// Session visibility is scoped to the authorized bot, not the whole team.
+const SESSIONS = ['message', 'aibot', 'sessions', 'list'];
+export const wecomProvider = {
+    id: 'wecom',
+    capability: 'im',
+    reference: true,
+    tools: ['wecom-cli'],
+    vars: [],
+    recipes: [
+        {
+            id: 'access',
+            tool: 'wecom-cli',
+            perEnv: false,
+            kind: 'manual',
+            title: 'Authorize WeCom session discovery',
+            instructions: 'Use the wecomcli-shared Skill to authorize wecom-cli. Session discovery is limited to the authorized bot and does not establish access to every team conversation.',
+            verify: {
+                command: SESSIONS,
+                json: { path: 'errcode', equals: 0, unmet: 'the WeCom API returned an error' },
+            },
+        },
+    ],
+    create: () => ({
+        label: 'WeCom conversations visible to the authorized bot',
+        command: ['wecom-cli', ...SESSIONS],
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/im/wecom/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/im/wecom/provider.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0EAA0E;AAK1E,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAAmC;IAC3D,EAAE,EAAE,OAAO;IACX,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC,WAAW,CAAC;IACpB,IAAI,EAAE,EAAE;IACR,OAAO,EAAE;QACP;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,mCAAmC;YAC1C,YAAY,EACV,oKAAoK;YACtK,MAAM,EAAE;gBACN,OAAO,EAAE,QAAQ;gBACjB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE;aAC/E;SACF;KACF;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,mDAAmD;QAC1D,OAAO,EAAE,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC;KACpC,CAAC;CACH,CAAC"}

package/dist/adapters/installer/brew.js

@@ -0,0 +1,16 @@
+// Homebrew, which spells installing and upgrading differently; the requested
+// operation picks the verb.
+export class BrewInstaller {
+    process;
+    id = 'brew';
+    constructor(process) {
+        this.process = process;
+    }
+    async available() {
+        return (await this.process.which('brew')) !== undefined;
+    }
+    vector(spec, options) {
+        return ['brew', options.update ? 'upgrade' : 'install', spec];
+    }
+}
+//# sourceMappingURL=brew.js.map

package/dist/adapters/installer/brew.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brew.js","sourceRoot":"","sources":["../../../src/adapters/installer/brew.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,4BAA4B;AAK5B,MAAM,OAAO,aAAa;IAGK;IAFpB,EAAE,GAAG,MAAM,CAAC;IAErB,YAA6B,OAA+B;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEhE,KAAK,CAAC,SAAS;QACb,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,SAAS,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,OAAsB;QACzC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/adapters/installer/go.js

@@ -0,0 +1,16 @@
+// `go install`, which only ever fetches: a spec without a version is asked for
+// `@latest`, so updating is the same request as installing.
+export class GoInstaller {
+    process;
+    id = 'go';
+    constructor(process) {
+        this.process = process;
+    }
+    async available() {
+        return (await this.process.which('go')) !== undefined;
+    }
+    vector(spec, _options) {
+        return ['go', 'install', spec.includes('@') ? spec : `${spec}@latest`];
+    }
+}
+//# sourceMappingURL=go.js.map

package/dist/adapters/installer/go.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"go.js","sourceRoot":"","sources":["../../../src/adapters/installer/go.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4DAA4D;AAK5D,MAAM,OAAO,WAAW;IAGO;IAFpB,EAAE,GAAG,IAAI,CAAC;IAEnB,YAA6B,OAA+B;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEhE,KAAK,CAAC,SAAS;QACb,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,SAAS,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,QAAuB;QAC1C,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/adapters/installer/manual.js

@@ -0,0 +1,11 @@
+// A tool installed by hand has no vector; the person gets the docs instead.
+export class ManualInstaller {
+    id = 'manual';
+    async available() {
+        return true;
+    }
+    vector() {
+        return undefined;
+    }
+}
+//# sourceMappingURL=manual.js.map

package/dist/adapters/installer/manual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.js","sourceRoot":"","sources":["../../../src/adapters/installer/manual.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAI5E,MAAM,OAAO,eAAe;IACjB,EAAE,GAAG,QAAQ,CAAC;IAEvB,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/adapters/installer/npm.js

@@ -0,0 +1,30 @@
+// npm's global install, with the registry passed through when the manifest
+// names one.
+import { registryArguments } from '../registry/registry-policy.js';
+export class NpmInstaller {
+    process;
+    id = 'npm';
+    constructor(process) {
+        this.process = process;
+    }
+    async available() {
+        return (await this.process.which('npm')) !== undefined;
+    }
+    // Install and update are the same request: whatever `latest` is now.
+    vector(spec, options) {
+        return [
+            'npm',
+            'install',
+            '-g',
+            `${spec}@latest`,
+            ...(options.registry === undefined
+                ? []
+                : registryArguments({
+                    packageName: spec,
+                    registry: options.registry,
+                    packageOnly: options.registryScope === 'package',
+                })),
+        ];
+    }
+}
+//# sourceMappingURL=npm.js.map

package/dist/adapters/installer/npm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.js","sourceRoot":"","sources":["../../../src/adapters/installer/npm.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,aAAa;AAIb,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE,MAAM,OAAO,YAAY;IAGM;IAFpB,EAAE,GAAG,KAAK,CAAC;IAEpB,YAA6B,OAA+B;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEhE,KAAK,CAAC,SAAS;QACb,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC;IACzD,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,IAAY,EAAE,OAAsB;QACzC,OAAO;YACL,KAAK;YACL,SAAS;YACT,IAAI;YACJ,GAAG,IAAI,SAAS;YAChB,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAChC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,iBAAiB,CAAC;oBAChB,WAAW,EAAE,IAAI;oBACjB,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,WAAW,EAAE,OAAO,CAAC,aAAa,KAAK,SAAS;iBACjD,CAAC,CAAC;SACR,CAAC;IACJ,CAAC;CACF"}

package/dist/adapters/issue-tracker/feishu-project/provider.js

@@ -0,0 +1,40 @@
+// Feishu Project through Meegle: a workspace entry and a local auth check.
+// Business queries and mutations remain the caller's responsibility.
+import { referenceEntry } from '../../reference/entry.js';
+export const feishuProjectProvider = {
+    id: 'feishu-project',
+    capability: 'issue-tracker',
+    reference: true,
+    tools: ['meegle'],
+    vars: [{ name: 'project_key', desc: 'verified project key or simple name', required: true }],
+    recipes: [
+        {
+            id: 'auth',
+            tool: 'meegle',
+            perEnv: false,
+            kind: 'manual',
+            title: 'Authenticate Meegle',
+            instructions: 'Run meegle auth login for the intended site, then verify the workspace project.',
+            verify: {
+                command: ['auth', 'status', '--format', 'json'],
+                json: { path: 'authenticated', equals: true },
+            },
+        },
+    ],
+    create: (_deps, vars) => referenceEntry({
+        template: {
+            label: 'Work items in {project_key}',
+            command: [
+                'meegle',
+                'project',
+                'search',
+                '--project-key',
+                '{project_key}',
+                '--format',
+                'json',
+            ],
+        },
+        vars,
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/issue-tracker/feishu-project/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/issue-tracker/feishu-project/provider.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qEAAqE;AAIrE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,CAAC,MAAM,qBAAqB,GAAmC;IACnE,EAAE,EAAE,gBAAgB;IACpB,UAAU,EAAE,eAAe;IAC3B,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,qCAAqC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5F,OAAO,EAAE;QACP;YACE,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,qBAAqB;YAC5B,YAAY,EACV,iFAAiF;YACnF,MAAM,EAAE;gBACN,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC;gBAC/C,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE;aAC9C;SACF;KACF;IACD,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,cAAc,CAAC;QACb,QAAQ,EAAE;YACR,KAAK,EAAE,6BAA6B;YACpC,OAAO,EAAE;gBACP,QAAQ;gBACR,SAAS;gBACT,QAAQ;gBACR,eAAe;gBACf,eAAe;gBACf,UAAU;gBACV,MAAM;aACP;SACF;QACD,IAAI;KACL,CAAC;CACL,CAAC"}

package/dist/adapters/issue-tracker/jira-cli/provider.js

@@ -0,0 +1,46 @@
+// Jira through the family CLI: a workspace entry and a credential check. Business queries
+// and transitions remain the caller's responsibility.
+import { familyService } from '../../family/service.js';
+import { referenceEntry } from '../../reference/entry.js';
+const PROJECT_ISSUES = ['issue', 'search', '--project', '{project}', '--format', 'json'];
+export const jiraCliProvider = {
+    id: 'jira-cli',
+    capability: 'issue-tracker',
+    settings: {
+        fields: ['base_url', 'context', 'flavor', 'auth_scheme', 'credential_url'],
+        authSchemes: ['pat', 'basic'],
+    },
+    reference: true,
+    tools: ['jira-cli'],
+    vars: [
+        { name: 'base_url', desc: 'verified Jira site URL', required: true },
+        { name: 'project', desc: 'project key', required: true },
+    ],
+    service: (settings) => familyService('jira-cli', settings, '0.7.0'),
+    recipes: [
+        {
+            id: 'access',
+            tool: 'jira-cli',
+            perEnv: false,
+            kind: 'manual',
+            title: 'Connect the Jira project',
+            instructions: 'Configure jira-cli for the intended site and obtain access to the declared project.',
+            open: '{base_url}',
+            // Credentials answer for a site, so the check is who they authenticate as.
+            verify: { command: ['whoami', '--format', 'json'] },
+        },
+    ],
+    create: (_deps, vars) => referenceEntry({
+        template: {
+            label: 'Work items in {project}',
+            command: [
+                'jira-cli',
+                ...(vars['context'] ? ['--use-context', vars['context']] : []),
+                ...PROJECT_ISSUES,
+            ],
+            url: '{base_url}',
+        },
+        vars,
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/issue-tracker/jira-cli/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/issue-tracker/jira-cli/provider.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,sDAAsD;AAItD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAEzF,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC7D,EAAE,EAAE,UAAU;IACd,UAAU,EAAE,eAAe;IAC3B,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,CAAC;QAC1E,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;KAC9B;IACD,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC,UAAU,CAAC;IACnB,IAAI,EAAE;QACJ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,wBAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE;KACzD;IACD,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;IACnE,OAAO,EAAE;QACP;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,0BAA0B;YACjC,YAAY,EACV,qFAAqF;YACvF,IAAI,EAAE,YAAY;YAClB,2EAA2E;YAC3E,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE;SACpD;KACF;IACD,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,cAAc,CAAC;QACb,QAAQ,EAAE;YACR,KAAK,EAAE,yBAAyB;YAChC,OAAO,EAAE;gBACP,UAAU;gBACV,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,GAAG,cAAc;aAClB;YACD,GAAG,EAAE,YAAY;SAClB;QACD,IAAI;KACL,CAAC;CACL,CAAC"}

package/dist/adapters/knowledge-base/confluence/provider.js

@@ -0,0 +1,72 @@
+// Confluence entry and space-access verification. The space check proves
+// access to this binding rather than merely finding a stored credential.
+import { familyService } from '../../family/service.js';
+import { referenceEntry } from '../../reference/entry.js';
+const SPACE = [
+    'space',
+    'get',
+    '{space}',
+    '--base-url',
+    '{base_url}',
+    '--format',
+    'json',
+    '--fields',
+    'key',
+];
+export const confluenceProvider = {
+    id: 'confluence',
+    capability: 'knowledge-base',
+    settings: {
+        fields: ['base_url', 'context', 'flavor', 'auth_scheme', 'credential_url'],
+        authSchemes: ['pat', 'basic'],
+    },
+    reference: true,
+    tools: ['confluence-cli'],
+    vars: [
+        { name: 'base_url', desc: 'verified Confluence site URL', required: true },
+        { name: 'space', desc: 'space key', required: true },
+    ],
+    service: (settings) => {
+        const service = familyService('confluence-cli', settings, '0.21.0');
+        return {
+            ...service,
+            recipes: [
+                ...service.recipes,
+                {
+                    id: 'access',
+                    tool: 'confluence-cli',
+                    perEnv: false,
+                    kind: 'manual',
+                    title: 'Verify access to the Confluence space',
+                    requires: ['credential'],
+                    verify: { command: ['--use-context', settings.context ?? '', ...SPACE] },
+                },
+            ],
+        };
+    },
+    recipes: [
+        {
+            id: 'access',
+            tool: 'confluence-cli',
+            perEnv: false,
+            kind: 'manual',
+            title: 'Connect the Confluence space',
+            instructions: 'Configure confluence-cli for the intended site and obtain read access to the declared space.',
+            open: '{base_url}',
+            verify: { command: SPACE },
+        },
+    ],
+    create: (_deps, vars) => referenceEntry({
+        template: {
+            label: 'Confluence space {space}',
+            command: [
+                'confluence-cli',
+                ...(vars['context'] ? ['--use-context', vars['context']] : []),
+                ...SPACE,
+            ],
+            url: '{base_url}',
+        },
+        vars,
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/knowledge-base/confluence/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/knowledge-base/confluence/provider.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,yEAAyE;AAIzE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,KAAK,GAAG;IACZ,OAAO;IACP,KAAK;IACL,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,MAAM;IACN,UAAU;IACV,KAAK;CACN,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAmC;IAChE,EAAE,EAAE,YAAY;IAChB,UAAU,EAAE,gBAAgB;IAC5B,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,CAAC;QAC1E,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;KAC9B;IACD,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC,gBAAgB,CAAC;IACzB,IAAI,EAAE;QACJ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,8BAA8B,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1E,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE;KACrD;IACD,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACpE,OAAO;YACL,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB;oBACE,EAAE,EAAE,QAAQ;oBACZ,IAAI,EAAE,gBAAgB;oBACtB,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,QAAiB;oBACvB,KAAK,EAAE,uCAAuC;oBAC9C,QAAQ,EAAE,CAAC,YAAY,CAAC;oBACxB,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,EAAE;iBACzE;aACF;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE;QACP;YACE,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,8BAA8B;YACrC,YAAY,EACV,8FAA8F;YAChG,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;SAC3B;KACF;IACD,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,cAAc,CAAC;QACb,QAAQ,EAAE;YACR,KAAK,EAAE,0BAA0B;YACjC,OAAO,EAAE;gBACP,gBAAgB;gBAChB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,GAAG,KAAK;aACT;YACD,GAAG,EAAE,YAAY;SAClB;QACD,IAAI;KACL,CAAC;CACL,CAAC"}

package/dist/adapters/knowledge-base/lark-wiki/provider.js

@@ -0,0 +1,30 @@
+// Feishu / Lark Wiki as the team's knowledge base: an entry into one space and a read-only
+// access check. Reading and writing documents remains the caller's responsibility.
+import { referenceEntry } from '../../reference/entry.js';
+const SPACE_NODES = ['wiki', '+node-list', '--space-id', '{space}', '--format', 'json'];
+export const larkWikiProvider = {
+    id: 'lark-wiki',
+    capability: 'knowledge-base',
+    reference: true,
+    tools: ['lark-cli'],
+    vars: [{ name: 'space', desc: 'wiki space id, from lark-cli wiki +space-list', required: true }],
+    recipes: [
+        {
+            // A step's identity is its tool and id, and lark-cli also serves `im`: two providers
+            // sharing one CLI must not claim the same step.
+            id: 'wiki-access',
+            tool: 'lark-cli',
+            perEnv: false,
+            kind: 'manual',
+            title: 'Authorize the Lark wiki space',
+            instructions: 'Use the lark-shared Skill to authorize lark-cli for the docs domain, then confirm the declared space is one the authorized identity can read.',
+            // Listing one node proves access to this space, not merely a stored credential.
+            verify: { command: [...SPACE_NODES, '--page-size', '1'] },
+        },
+    ],
+    create: (_deps, vars) => referenceEntry({
+        template: { label: 'Lark wiki space {space}', command: ['lark-cli', ...SPACE_NODES] },
+        vars,
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/knowledge-base/lark-wiki/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/knowledge-base/lark-wiki/provider.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,mFAAmF;AAInF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,EAAE,EAAE,WAAW;IACf,UAAU,EAAE,gBAAgB;IAC5B,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC,UAAU,CAAC;IACnB,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,+CAA+C,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAChG,OAAO,EAAE;QACP;YACE,qFAAqF;YACrF,gDAAgD;YAChD,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,+BAA+B;YACtC,YAAY,EACV,+IAA+I;YACjJ,gFAAgF;YAChF,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,WAAW,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE;SAC1D;KACF;IACD,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,cAAc,CAAC;QACb,QAAQ,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,CAAC,UAAU,EAAE,GAAG,WAAW,CAAC,EAAE;QACrF,IAAI;KACL,CAAC;CACL,CAAC"}

package/dist/adapters/log-store/openobserve-cli/provider.js

@@ -0,0 +1,52 @@
+// OpenObserve through openobserve-cli: every environment is its own server,
+// held as a named context inside the tool's configuration.
+import { familyService } from '../../family/service.js';
+import { TemplatePlatform } from '../../platform/template-platform.js';
+import { OPENOBSERVE_RECIPES } from './recipes.js';
+export const openobserveCliProvider = {
+    id: 'openobserve-cli',
+    capability: 'log-store',
+    impliedByPlatform: ['openobserve'],
+    settings: {
+        fields: ['base_url', 'context', 'org', 'auth_scheme', 'credential_url'],
+        authSchemes: ['basic', 'token', 'session'],
+    },
+    tools: ['openobserve-cli'],
+    service: (settings) => familyService('openobserve-cli', settings, '0.14.0', 'authenticated'),
+    recipes: OPENOBSERVE_RECIPES,
+    vars: [],
+    envVars: [
+        { name: 'context', desc: 'openobserve-cli context name for this environment', required: true },
+        { name: 'stream', desc: 'log stream template, may use {svc}', required: true },
+    ],
+    create: () => new TemplatePlatform({
+        id: 'openobserve-cli',
+        capability: 'log-store',
+        label: 'OpenObserve stream {stream}',
+        optionalFlags: { base_url: '--base-url', org: '--org', auth_scheme: '--auth-scheme' },
+        command: [
+            'openobserve-cli',
+            'search',
+            'run',
+            '--use-context',
+            '{context}',
+            '--stream',
+            '{stream}',
+            '--from',
+            'now-1h',
+        ],
+        probe: {
+            label: 'stream {stream}',
+            command: [
+                'openobserve-cli',
+                'stream',
+                'get',
+                '--use-context',
+                '{context}',
+                '--',
+                '{stream}',
+            ],
+        },
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/log-store/openobserve-cli/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/log-store/openobserve-cli/provider.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,2DAA2D;AAI3D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,CAAC,MAAM,sBAAsB,GAAiC;IAClE,EAAE,EAAE,iBAAiB;IACrB,UAAU,EAAE,WAAW;IACvB,iBAAiB,EAAE,CAAC,aAAa,CAAC;IAClC,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,gBAAgB,CAAC;QACvE,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;KAC3C;IACD,KAAK,EAAE,CAAC,iBAAiB,CAAC;IAC1B,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,CAAC;IAC5F,OAAO,EAAE,mBAAmB;IAC5B,IAAI,EAAE,EAAE;IACR,OAAO,EAAE;QACP,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,mDAAmD,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC9F,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,oCAAoC,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/E;IACD,MAAM,EAAE,GAAG,EAAE,CACX,IAAI,gBAAgB,CAAC;QACnB,EAAE,EAAE,iBAAiB;QACrB,UAAU,EAAE,WAAW;QACvB,KAAK,EAAE,6BAA6B;QACpC,aAAa,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE;QACrF,OAAO,EAAE;YACP,iBAAiB;YACjB,QAAQ;YACR,KAAK;YACL,eAAe;YACf,WAAW;YACX,UAAU;YACV,UAAU;YACV,QAAQ;YACR,QAAQ;SACT;QACD,KAAK,EAAE;YACL,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE;gBACP,iBAAiB;gBACjB,QAAQ;gBACR,KAAK;gBACL,eAAe;gBACf,WAAW;gBACX,IAAI;gBACJ,UAAU;aACX;SACF;KACF,CAAC;CACL,CAAC"}

package/dist/adapters/log-store/openobserve-cli/recipes.js

@@ -0,0 +1,16 @@
+// The one step OpenObserve needs in each environment: the context its own
+// wizard writes, named after the environment.
+export const OPENOBSERVE_RECIPES = [
+    {
+        id: 'context',
+        tool: 'openobserve-cli',
+        perEnv: true,
+        kind: 'run',
+        phase: 'authenticate',
+        title: 'Add the OpenObserve context "{context}" for {env}',
+        instructions: 'The wizard asks for the server URL, organization and credentials of the {env} OpenObserve.',
+        run: ['config', 'init', '--context', '{context}'],
+        verify: { command: ['auth', 'status', '--use-context', '{context}'] },
+    },
+];
+//# sourceMappingURL=recipes.js.map

package/dist/adapters/log-store/openobserve-cli/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../../../src/adapters/log-store/openobserve-cli/recipes.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8CAA8C;AAI9C,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,mDAAmD;QAC1D,YAAY,EACV,4FAA4F;QAC9F,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC;QACjD,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE;KACtE;CACF,CAAC"}