@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/adapters/manifest-source/git-repo.js

@@ -0,0 +1,162 @@
+// Materialize and safely refresh Git manifest checkouts, preserving local work.
+import { realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { PAYLOAD_PATHS } from './payload.js';
+export class GitRepoSource {
+    url;
+    process;
+    git;
+    localDirectory;
+    fs;
+    kind = 'repo';
+    constructor(url, process, git, localDirectory, fs) {
+        this.url = url;
+        this.process = process;
+        this.git = git;
+        this.localDirectory = localDirectory;
+        this.fs = fs;
+    }
+    get description() {
+        return this.url;
+    }
+    async inspect(currentDir) {
+        if (currentDir !== undefined)
+            return this.inspectRefresh(currentDir);
+        return this.localDirectory === undefined
+            ? undefined
+            : this.inspectCommit(this.localDirectory, 'HEAD');
+    }
+    async inspectRefresh(dir) {
+        const branch = (await this.git.remoteHead(dir, 'upstream')) ?? 'main';
+        const state = await this.git.status(dir);
+        if (state.branch !== branch || (await this.worktreeProtection(dir, state)) !== undefined)
+            return this.inspectWorktree(dir);
+        if (this.localDirectory === undefined)
+            return undefined;
+        const head = await this.git.sha(dir, 'HEAD');
+        if (head === undefined)
+            return undefined;
+        const ancestor = await this.process.run([
+            'git',
+            '-C',
+            this.localDirectory,
+            'merge-base',
+            '--is-ancestor',
+            head,
+            branch,
+        ]);
+        if (ancestor.code === 1)
+            return this.inspectWorktree(dir);
+        if (ancestor.code !== 0)
+            return undefined;
+        return this.inspectCommit(this.localDirectory, branch);
+    }
+    async worktreeProtection(dir, state) {
+        if (state.dirty)
+            return `uncommitted changes on ${state.branch ?? 'a detached HEAD'}`;
+        if (state.untracked > 0)
+            return 'untracked files in the manifest source';
+        const [untracked, ignored] = await Promise.all([
+            this.process.run(['git', '-C', dir, 'ls-files', '--others', '--exclude-standard']),
+            this.process.run([
+                'git',
+                '-C',
+                dir,
+                'ls-files',
+                '--others',
+                '--ignored',
+                '--exclude-standard',
+                '--',
+                ...PAYLOAD_PATHS.map((file) => file.split(path.sep).join('/')),
+            ]),
+        ]);
+        if (untracked.code !== 0 || ignored.code !== 0)
+            return 'source payload status could not be verified; the manifest worktree was preserved';
+        if (untracked.stdout.length > 0)
+            return 'untracked files in the manifest source';
+        if (ignored.stdout.length > 0)
+            return 'ignored source payload affects workspace preparation; the manifest worktree was preserved';
+        return undefined;
+    }
+    inspectWorktree(dir) {
+        const fs = this.fs;
+        return fs === undefined
+            ? undefined
+            : { root: dir, contents: 'worktree', readText: (file) => fs.readText(path.join(dir, file)) };
+    }
+    inspectCommit(dir, ref) {
+        return {
+            root: `${dir}@${ref}`,
+            contents: 'commit',
+            readText: async (file) => {
+                const result = await this.process.run(['git', '-C', dir, 'show', `${ref}:${file}`]);
+                if (result.code === 0)
+                    return result.stdout;
+                if (file !== 'manifest/workspace.yaml')
+                    return undefined;
+                throw new DevkitError('config', 'MANIFEST_SOURCE_INVALID', 'Local Git source has no committed manifest/workspace.yaml', {
+                    nextSteps: [
+                        'Commit the manifest source before initializing, or use a directory snapshot.',
+                    ],
+                });
+            },
+        };
+    }
+    async materialize(dir) {
+        const top = await this.git.toplevel(dir);
+        if (top !== undefined && top === (await realpath(dir))) {
+            const remotes = await this.git.remotes(dir);
+            if (remotes['upstream'] !== this.url)
+                throw new DevkitError('conflict', 'SOURCE_MISMATCH', 'Existing manifest checkout has a different upstream', { nextSteps: ['Inspect the existing source checkout before retrying.'] });
+            await this.refresh(dir);
+            return;
+        }
+        const result = await this.process.run([
+            'git',
+            'clone',
+            '--quiet',
+            '--origin',
+            'upstream',
+            this.url,
+            dir,
+        ]);
+        if (result.code !== 0) {
+            throw new DevkitError('network', 'MANIFEST_CLONE_FAILED', `Could not clone ${this.url}: ${lastLine(result.stderr)}`, {
+                hint: 'The manifest repository must be reachable and readable with your git credentials.',
+                nextSteps: [`git clone ${this.url}`],
+            });
+        }
+    }
+    async refresh(dir) {
+        try {
+            await this.git.fetch(dir, 'upstream');
+        }
+        catch (err) {
+            throw new DevkitError('network', 'MANIFEST_REFRESH_FAILED', `Could not fetch the manifest repository into ${dir}: ${err instanceof Error ? err.message : String(err)}`, {
+                hint: 'The manifest repository must be reachable with your git credentials.',
+                nextSteps: [`git -C ${dir} fetch upstream`],
+            });
+        }
+        const branch = (await this.git.remoteHead(dir, 'upstream')) ?? 'main';
+        const state = await this.git.status(dir);
+        const kept = (reason) => ({ result: 'kept', reason });
+        const onBranch = state.branch === branch;
+        const protection = await this.worktreeProtection(dir, state);
+        if (protection !== undefined)
+            return kept(protection);
+        const outcome = await this.git.fastForward(dir, 'upstream', branch);
+        if (outcome === 'diverged') {
+            const suffix = onBranch ? '' : '; its ref was not moved';
+            return kept(`local commits on ${branch} diverge from upstream${suffix}`);
+        }
+        if (!onBranch)
+            return kept(`on ${state.branch ?? 'a detached HEAD'}, not ${branch}; only the ${branch} ref moved`);
+        return { result: outcome };
+    }
+}
+function lastLine(text) {
+    const lines = text.trim().split('\n');
+    return lines[lines.length - 1] ?? '';
+}
+//# sourceMappingURL=git-repo.js.map

package/dist/adapters/manifest-source/git-repo.js.map

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

package/dist/adapters/manifest-source/payload.js

@@ -0,0 +1,41 @@
+// The distributable source payload shared by directory and stdin imports.
+// Git metadata and local tool configuration are not workspace content.
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { MANIFEST_FILES } from '../../domain/manifest/files.js';
+export const PAYLOAD_PATHS = [
+    ...Object.values(MANIFEST_FILES),
+    'AGENTS.md',
+    'README.md',
+    'docs',
+    'skills',
+];
+export function assertPayloadPath(name) {
+    const parts = name.split('/');
+    if (name.includes('\\') ||
+        name.includes('\0') ||
+        parts.some((part) => part === '' || part === '.' || part === '..') ||
+        !PAYLOAD_PATHS.some((root) => name === root || ((root === 'docs' || root === 'skills') && name.startsWith(`${root}/`))))
+        throw new DevkitError('config', 'MANIFEST_SOURCE_INVALID', `Invalid source payload path: ${name}`, {
+            nextSteps: [
+                `Name the payload entry ${PAYLOAD_PATHS.join(', ')} or a path under docs/ or skills/, without backslash, "." or ".." segments.`,
+            ],
+        });
+}
+export async function preparePayload(fs, dir, changed, replace) {
+    const existing = [];
+    for (const name of changed) {
+        const target = path.join(dir, name);
+        if ((await fs.exists(target)) || (await fs.readLink(target)) !== undefined)
+            existing.push(target);
+    }
+    if (existing.length === 0)
+        return;
+    if (replace !== undefined && (await replace(existing)))
+        return;
+    throw new DevkitError('conflict', 'MANIFEST_REPLACE_REQUIRED', 'Existing source files were left unchanged', {
+        hint: `Confirm replacement of: ${existing.join(', ')}`,
+        nextSteps: ['Run init interactively to review and back up the existing files.'],
+    });
+}
+//# sourceMappingURL=payload.js.map

package/dist/adapters/manifest-source/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../src/adapters/manifest-source/payload.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,uEAAuE;AAEvE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIhE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC;IAChC,WAAW;IACX,WAAW;IACX,MAAM;IACN,QAAQ;CACT,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IACE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC;QAClE,CAAC,aAAa,CAAC,IAAI,CACjB,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAC3F;QAED,MAAM,IAAI,WAAW,CACnB,QAAQ,EACR,yBAAyB,EACzB,gCAAgC,IAAI,EAAE,EACtC;YACE,SAAS,EAAE;gBACT,0BAA0B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,6EAA6E;aAChI;SACF,CACF,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAc,EACd,GAAW,EACX,OAA0B,EAC1B,OAAsB;IAEtB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,SAAS;YACxE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAClC,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO;IAC/D,MAAM,IAAI,WAAW,CACnB,UAAU,EACV,2BAA2B,EAC3B,2CAA2C,EAC3C;QACE,IAAI,EAAE,2BAA2B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACtD,SAAS,EAAE,CAAC,kEAAkE,CAAC;KAChF,CACF,CAAC;AACJ,CAAC"}

package/dist/adapters/manifest-source/stdin.js

@@ -0,0 +1,88 @@
+// stdin accepts workspace.yaml or a portable source bundle. Bundles preserve
+// accompanying docs, Skills and binary assets without borrowing local paths.
+import { randomUUID } from 'node:crypto';
+import YAML from 'yaml';
+import { DevkitError } from '../../domain/errors.js';
+import { MANIFEST_FILES } from '../../domain/manifest/files.js';
+import { FileSource } from './file.js';
+import { assertPayloadPath } from './payload.js';
+export class StdinSource {
+    text;
+    fs;
+    replace;
+    kind = 'stdin';
+    description = '-';
+    constructor(text, fs, replace) {
+        this.text = text;
+        this.fs = fs;
+        this.replace = replace;
+    }
+    async inspect() {
+        const files = this.files();
+        return {
+            root: 'stdin',
+            readText: async (name) => {
+                const file = files.find((item) => item.name === name);
+                return file === undefined ? undefined : Buffer.from(file.bytes).toString('utf8');
+            },
+        };
+    }
+    async materialize(dir) {
+        const files = this.files();
+        const scratch = `${dir}.import-${randomUUID()}`;
+        try {
+            for (const file of files)
+                await this.fs.writeBytes(`${scratch}/${file.name}`, file.bytes, file.executable);
+            await new FileSource(scratch, this.fs, this.replace).materialize(dir);
+        }
+        finally {
+            await this.fs.remove(scratch);
+        }
+    }
+    files() {
+        let value;
+        try {
+            value = YAML.parse(this.text);
+        }
+        catch {
+            throw invalid('stdin must contain valid YAML or JSON');
+        }
+        if (!record(value) || !('source_version' in value))
+            return [{ name: MANIFEST_FILES.workspace, bytes: Buffer.from(this.text), executable: false }];
+        if (value['source_version'] !== 1 || !record(value['files']))
+            throw invalid('Expected source_version: 1 and a files mapping');
+        const files = Object.entries(value['files']).map(([name, content]) => decode(name, content));
+        if (!files.some((file) => file.name === MANIFEST_FILES.workspace))
+            throw invalid('The bundle requires manifest/workspace.yaml');
+        for (const file of files)
+            if (files.some((other) => other.name.startsWith(`${file.name}/`)))
+                throw invalid(`A file overlaps a directory: ${file.name}`);
+        return files;
+    }
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function decode(name, content) {
+    assertPayloadPath(name);
+    if (name === 'docs' || name === 'skills')
+        throw invalid(`${name} must contain files`);
+    if (typeof content === 'string')
+        return { name, bytes: Buffer.from(content), executable: false };
+    if (!record(content) ||
+        typeof content['base64'] !== 'string' ||
+        (content['executable'] !== undefined && typeof content['executable'] !== 'boolean'))
+        throw invalid(`${name} must be text or {base64, executable?}`);
+    const bytes = Buffer.from(content['base64'], 'base64');
+    if (bytes.toString('base64') !== content['base64'])
+        throw invalid(`Invalid base64 for ${name}`);
+    return { name, bytes, executable: content['executable'] === true };
+}
+function invalid(message) {
+    return new DevkitError('config', 'MANIFEST_SOURCE_INVALID', message, {
+        nextSteps: [
+            'Send a JSON object mapping manifest payload paths to text or {base64, executable?}, then retry.',
+        ],
+    });
+}
+//# sourceMappingURL=stdin.js.map

package/dist/adapters/manifest-source/stdin.js.map

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

package/dist/adapters/meeting/tencent-meeting/provider.js

@@ -0,0 +1,29 @@
+// Tencent Meeting through tmeet. Readiness is one read-only query for the signed-in
+// member's upcoming meetings: `tmeet auth status` exits zero when signed out, so it proves
+// nothing. fx never creates, changes or joins a meeting.
+const UPCOMING = ['meeting', 'list'];
+export const tencentMeetingProvider = {
+    id: 'tencent-meeting',
+    capability: 'meeting',
+    reference: true,
+    tools: ['tmeet'],
+    vars: [],
+    recipes: [
+        {
+            id: 'meeting-access',
+            tool: 'tmeet',
+            perEnv: false,
+            kind: 'run',
+            phase: 'authenticate',
+            title: 'Sign in to Tencent Meeting with your own account',
+            instructions: 'Run the sign-in in your own terminal and complete the browser authorization it prints; it waits for that page. If it reports the user is already initialized, run tmeet auth logout first.',
+            run: ['auth', 'login'],
+            verify: { command: [...UPCOMING, '--page-size', '1'] },
+        },
+    ],
+    create: () => ({
+        label: "Tencent Meeting meetings of the signed-in member's account",
+        command: ['tmeet', ...UPCOMING],
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/meeting/tencent-meeting/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/meeting/tencent-meeting/provider.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,2FAA2F;AAC3F,yDAAyD;AAKzD,MAAM,QAAQ,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAErC,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IACpE,EAAE,EAAE,iBAAiB;IACrB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC,OAAO,CAAC;IAChB,IAAI,EAAE,EAAE;IACR,OAAO,EAAE;QACP;YACE,EAAE,EAAE,gBAAgB;YACpB,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,cAAc;YACrB,KAAK,EAAE,kDAAkD;YACzD,YAAY,EACV,4LAA4L;YAC9L,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;YACtB,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE;SACvD;KACF;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,4DAA4D;QACnE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC;KAChC,CAAC;CACH,CAAC"}

package/dist/adapters/metrics/prometheus-cli/provider.js

@@ -0,0 +1,40 @@
+// Prometheus through prometheus-cli: every environment is its own server, held as a named
+// context inside the tool's configuration. A service is found by its scrape job, the one
+// label every scraped series carries. There is no probe: a selector that matches nothing
+// still succeeds, so no query can tell a missing job from a silent one.
+import { TemplatePlatform } from '../../platform/template-platform.js';
+import { PROMETHEUS_RECIPES } from './recipes.js';
+import { BINARY, prometheusService } from './service.js';
+export const prometheusCliProvider = {
+    id: BINARY,
+    capability: 'metrics',
+    impliedByPlatform: ['prometheus'],
+    settings: {
+        fields: ['base_url', 'context', 'auth_scheme', 'credential_url'],
+        authSchemes: ['none', 'basic', 'bearer'],
+    },
+    tools: [BINARY],
+    service: prometheusService,
+    recipes: PROMETHEUS_RECIPES,
+    vars: [],
+    envVars: [
+        { name: 'context', desc: 'prometheus-cli context name for this environment', required: true },
+        { name: 'job', desc: 'scrape job template, may use {svc}', required: true },
+    ],
+    create: () => new TemplatePlatform({
+        id: BINARY,
+        capability: 'metrics',
+        label: 'Prometheus job {job}',
+        optionalFlags: { base_url: '--base-url', auth_scheme: '--auth-scheme' },
+        command: [
+            BINARY,
+            'query',
+            'instant',
+            '--use-context',
+            '{context}',
+            '--query',
+            'up{job="{job}"}',
+        ],
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/metrics/prometheus-cli/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/metrics/prometheus-cli/provider.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,yFAAyF;AACzF,yFAAyF;AACzF,wEAAwE;AAIxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,CAAC,MAAM,qBAAqB,GAAgC;IAChE,EAAE,EAAE,MAAM;IACV,UAAU,EAAE,SAAS;IACrB,iBAAiB,EAAE,CAAC,YAAY,CAAC;IACjC,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,CAAC;QAChE,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;KACzC;IACD,KAAK,EAAE,CAAC,MAAM,CAAC;IACf,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,kBAAkB;IAC3B,IAAI,EAAE,EAAE;IACR,OAAO,EAAE;QACP,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,kDAAkD,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7F,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,oCAAoC,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC5E;IACD,MAAM,EAAE,GAAG,EAAE,CACX,IAAI,gBAAgB,CAAC;QACnB,EAAE,EAAE,MAAM;QACV,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,sBAAsB;QAC7B,aAAa,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE;QACvE,OAAO,EAAE;YACP,MAAM;YACN,OAAO;YACP,SAAS;YACT,eAAe;YACf,WAAW;YACX,SAAS;YACT,iBAAiB;SAClB;KACF,CAAC;CACL,CAAC"}

package/dist/adapters/metrics/prometheus-cli/recipes.js

@@ -0,0 +1,17 @@
+// The one step Prometheus needs in each environment when the manifest declares no
+// service: the context its own wizard writes, named after the environment.
+import { answers, BINARY } from './service.js';
+export const PROMETHEUS_RECIPES = [
+    {
+        id: 'context',
+        tool: BINARY,
+        perEnv: true,
+        kind: 'run',
+        phase: 'authenticate',
+        title: 'Add the Prometheus context "{context}" for {env}',
+        instructions: 'The wizard asks for the server URL of the {env} Prometheus and, only where a gateway in front of it requires one, a credential.',
+        run: ['config', 'init', '--context', '{context}'],
+        verify: answers(['--use-context', '{context}']),
+    },
+];
+//# sourceMappingURL=recipes.js.map

package/dist/adapters/metrics/prometheus-cli/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../../../src/adapters/metrics/prometheus-cli/recipes.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,2EAA2E;AAI3E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,kDAAkD;QACzD,YAAY,EACV,iIAAiI;QACnI,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC;QACjD,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;KAChD;CACF,CAAC"}

package/dist/adapters/metrics/prometheus-cli/service.js

@@ -0,0 +1,34 @@
+// How prometheus-cli is prepared for a declared server. Prometheus has no accounts of its
+// own, so a server is usually declared with the `none` scheme: there is no login to reuse
+// or obtain — `auth login` refuses the scheme — and readiness is whether the server answers.
+import { familyService, serviceScope } from '../../family/service.js';
+export const BINARY = 'prometheus-cli';
+// `auth status` exits zero when the server does not answer, so only `authenticated` tells.
+// Its own request timeout stays under fx's check deadline: a server that never answers is
+// then the companion's verdict rather than a check fx had to abandon.
+export function answers(scope) {
+    return {
+        command: [...scope, '--timeout', '10s', 'auth', 'status', '--format', 'json'],
+        json: { path: 'authenticated', equals: true, reason: 'error' },
+    };
+}
+export function prometheusService(settings) {
+    const family = familyService(BINARY, settings, '0.2.0', 'authenticated');
+    if (settings.auth_scheme !== 'none')
+        return family;
+    return {
+        ...family,
+        recipes: [
+            {
+                id: 'access',
+                tool: BINARY,
+                perEnv: false,
+                kind: 'manual',
+                title: 'Reach the Prometheus server',
+                instructions: 'This server takes no sign-in. Connect to the network it is served on; no token or auth login is involved.',
+                verify: answers(serviceScope(settings)),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/adapters/metrics/prometheus-cli/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../../src/adapters/metrics/prometheus-cli/service.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,0FAA0F;AAC1F,6FAA6F;AAK7F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEtE,MAAM,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAC;AAEvC,2FAA2F;AAC3F,0FAA0F;AAC1F,sEAAsE;AACtE,MAAM,UAAU,OAAO,CAAC,KAAwB;IAC9C,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC;QAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAyB;IACzD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IACzE,IAAI,QAAQ,CAAC,WAAW,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACnD,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,QAAQ;gBACZ,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,6BAA6B;gBACpC,YAAY,EACV,2GAA2G;gBAC7G,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;aACxC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/platform/template-platform.js

@@ -0,0 +1,41 @@
+// The common shape of a platform adapter: a label, a default command template and an
+// optional page template, filled from the variables the caller merged. Unresolved
+// placeholders stay visible so the reader sees what the manifest did not say.
+import { substitute, substituteAll } from '../../domain/template.js';
+export class TemplatePlatform {
+    template;
+    id;
+    capability;
+    constructor(template) {
+        this.template = template;
+        this.id = template.id;
+        this.capability = template.capability;
+    }
+    probe(vars) {
+        const { probe } = this.template;
+        if (probe === undefined)
+            return undefined;
+        const template = this.command(probe.command, vars);
+        return {
+            label: substitute(probe.label, vars).text,
+            command: substituteAll(template, vars).vector,
+            template,
+        };
+    }
+    locate(vars) {
+        const { template } = this;
+        return {
+            label: substitute(template.label, vars).text,
+            command: substituteAll(this.command(template.command, vars), vars).vector,
+            ...(template.url === undefined ? {} : { url: substitute(template.url, vars).text }),
+        };
+    }
+    command(vector, vars) {
+        const optional = Object.entries(this.template.optionalFlags ?? {}).flatMap(([key, flag]) => vars[key] ? [flag, `{${key}}`] : []);
+        const separator = vector.indexOf('--');
+        if (separator < 0)
+            return [...vector, ...optional];
+        return [...vector.slice(0, separator), ...optional, ...vector.slice(separator)];
+    }
+}
+//# sourceMappingURL=template-platform.js.map

package/dist/adapters/platform/template-platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-platform.js","sourceRoot":"","sources":["../../../src/adapters/platform/template-platform.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,kFAAkF;AAClF,8EAA8E;AAI9E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAa,MAAM,0BAA0B,CAAC;AAahF,MAAM,OAAO,gBAAgB;IAIE;IAHpB,EAAE,CAAS;IACX,UAAU,CAAa;IAEhC,YAA6B,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;QACrD,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAU;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnD,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI;YACzC,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,MAAM;YAC7C,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAU;QACf,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI;YAC5C,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM;YACzE,GAAG,CAAC,QAAQ,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;SACpF,CAAC;IACJ,CAAC;IACO,OAAO,CAAC,MAAyB,EAAE,IAAU;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CACzF,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CACpC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,SAAS,GAAG,CAAC;YAAE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAClF,CAAC;CACF"}

package/dist/adapters/process/deadline-process.js

@@ -0,0 +1,21 @@
+// A lifecycle worker lends every companion command the remaining task budget.
+// The underlying process adapter retains responsibility for cancellation.
+export class DeadlineProcess {
+    process;
+    deadline = performance.now() + 29000;
+    constructor(process) {
+        this.process = process;
+    }
+    which(binary, options) {
+        return this.process.which(binary, options);
+    }
+    run(vector, options = {}) {
+        return this.process.run(vector, {
+            ...options,
+            interactive: false,
+            timeoutMs: Math.max(1, Math.min(options.timeoutMs ?? 15000, 15000, this.deadline - performance.now())),
+            env: { ...options.env, GIT_TERMINAL_PROMPT: '0', GCM_INTERACTIVE: 'Never' },
+        });
+    }
+}
+//# sourceMappingURL=deadline-process.js.map

package/dist/adapters/process/deadline-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline-process.js","sourceRoot":"","sources":["../../../src/adapters/process/deadline-process.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAI1E,MAAM,OAAO,eAAe;IAEG;IADZ,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IACtD,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IACjD,KAAK,CAAC,MAAc,EAAE,OAAyC;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,GAAG,CAAC,MAAyB,EAAE,UAAsB,EAAE;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;YAC9B,GAAG,OAAO;YACV,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,IAAI,CAAC,GAAG,CACjB,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,CAC/E;YACD,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE;SAC5E,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/adapters/process/diagnostic-process.js

@@ -0,0 +1,53 @@
+// Process diagnostics decorate the one subprocess port, preserving its result
+// while emitting a bounded, credential-free account of each completed call.
+import { redactText, redactVector, summarizeDiagnostic } from '../../domain/diagnostics.js';
+export class DiagnosticProcess {
+    inner;
+    diagnostics;
+    constructor(inner, diagnostics) {
+        this.inner = inner;
+        this.diagnostics = diagnostics;
+    }
+    async run(vector, options = {}) {
+        try {
+            const result = await this.inner.run(vector, options);
+            this.diagnostics.emit(eventOf(vector, options, result));
+            return result;
+        }
+        catch (err) {
+            const stderr = options.sensitiveOutput
+                ? undefined
+                : summarizeDiagnostic(err instanceof Error ? err.message : String(err));
+            this.diagnostics.emit({
+                ...baseEvent(vector, options),
+                ...(stderr === undefined ? {} : { stderr }),
+            });
+            throw err;
+        }
+    }
+    which(binary, options) {
+        return this.inner.which(binary, options);
+    }
+}
+function eventOf(vector, options, result) {
+    const stderr = options.sensitiveOutput ? undefined : summarizeDiagnostic(result.stderr);
+    return {
+        ...baseEvent(vector, options),
+        exit_code: result.code,
+        ...(stderr === undefined ? {} : { stderr }),
+    };
+}
+function baseEvent(vector, options) {
+    const context = options.diagnostic;
+    return {
+        kind: 'process',
+        phase: redactText(context?.phase ?? 'subprocess'),
+        vector: redactVector(vector),
+        ...(options.cwd === undefined ? {} : { cwd: redactText(options.cwd) }),
+        ...(options.timeoutMs === undefined ? {} : { timeout_ms: options.timeoutMs }),
+        ...(context?.capability === undefined ? {} : { capability: context.capability }),
+        ...(context?.provider === undefined ? {} : { provider: context.provider }),
+        ...(context?.binding === undefined ? {} : { binding: context.binding }),
+    };
+}
+//# sourceMappingURL=diagnostic-process.js.map

package/dist/adapters/process/diagnostic-process.js.map

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