@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/adapters/process/terminate.js

@@ -0,0 +1,32 @@
+// Only an owned child PID is eligible for cleanup. Windows has no POSIX
+// process groups; taskkill traverses the child tree while its root is alive.
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+export function terminateChild(child, group = false) {
+    if (child.pid === undefined)
+        return;
+    if ((!group || process.platform === 'win32') &&
+        (child.exitCode !== null || child.signalCode !== null))
+        return;
+    try {
+        if (process.platform === 'win32') {
+            const root = process.env.SystemRoot ?? process.env.SYSTEMROOT ?? 'C:\\Windows';
+            const result = spawnSync(path.join(root, 'System32', 'taskkill.exe'), ['/PID', String(child.pid), '/T', '/F'], {
+                stdio: 'ignore',
+                windowsHide: true,
+                timeout: 500,
+            });
+            if (result.status === 0)
+                return;
+        }
+        else if (group) {
+            process.kill(-child.pid, 'SIGKILL');
+            return;
+        }
+    }
+    catch {
+        // Fall back to the direct child; never broaden cleanup to an image name.
+    }
+    child.kill('SIGKILL');
+}
+//# sourceMappingURL=terminate.js.map

package/dist/adapters/process/terminate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminate.js","sourceRoot":"","sources":["../../../src/adapters/process/terminate.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,6EAA6E;AAE7E,OAAO,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AAClE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,cAAc,CAAC,KAAmB,EAAE,KAAK,GAAG,KAAK;IAC/D,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO;IACpC,IACE,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;QACxC,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;QAEtD,OAAO;IACT,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,aAAa,CAAC;YAC/E,MAAM,MAAM,GAAG,SAAS,CACtB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC,EAC3C,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EACvC;gBACE,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,GAAG;aACb,CACF,CAAC;YACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;QAClC,CAAC;aAAM,IAAI,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACxB,CAAC"}

package/dist/adapters/process/url-opener.js

@@ -0,0 +1,23 @@
+// Opening a URL is a desktop effect, independent of repository lookup.
+import { powershellVector } from './powershell.js';
+export class SystemUrlOpener {
+    process;
+    platform;
+    constructor(process, platform = globalThis.process.platform) {
+        this.process = process;
+        this.platform = platform;
+    }
+    async open(url) {
+        try {
+            const vector = this.platform === 'win32'
+                ? powershellVector("$ErrorActionPreference='Stop'; Start-Process -FilePath $env:FX_OPEN_URL")
+                : [this.platform === 'darwin' ? 'open' : 'xdg-open', url];
+            const result = await this.process.run(vector, { env: { FX_OPEN_URL: url }, timeoutMs: 3000 });
+            return result.code === 0;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=url-opener.js.map

package/dist/adapters/process/url-opener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-opener.js","sourceRoot":"","sources":["../../../src/adapters/process/url-opener.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAIvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,OAAO,eAAe;IAEP;IACA;IAFnB,YACmB,OAAgB,EAChB,WAAW,UAAU,CAAC,OAAO,CAAC,QAAQ;QADtC,YAAO,GAAP,OAAO,CAAS;QAChB,aAAQ,GAAR,QAAQ,CAA8B;IACtD,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,GACV,IAAI,CAAC,QAAQ,KAAK,OAAO;gBACvB,CAAC,CAAC,gBAAgB,CACd,yEAAyE,CAC1E;gBACH,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9F,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,38 @@
+// Every subprocess fx starts is something it waits on, so the one subprocess port is
+// where a watcher learns what that is. A child that owns the terminal is handed it, and
+// one that merely stays in fx's terminal session is known to be able to ask there.
+import path from 'node:path';
+import { redactText } from '../../domain/diagnostics.js';
+import { leavesSession } from './node-process.js';
+export class WatchedProcess {
+    inner;
+    activity;
+    constructor(inner, activity) {
+        this.inner = inner;
+        this.activity = activity;
+    }
+    async run(vector, options = {}) {
+        const release = options.interactive === true
+            ? this.activity.handover()
+            : this.activity.waiting({
+                label: labelOf(vector, options),
+                mayAsk: !leavesSession(options),
+            });
+        try {
+            return await this.inner.run(vector, options);
+        }
+        finally {
+            release();
+        }
+    }
+    which(binary, options) {
+        return this.inner.which(binary, options);
+    }
+}
+// The caller's own name for the call, or the executable alone: arguments may carry
+// what must not reach a screen.
+function labelOf(vector, options) {
+    const phase = options.diagnostic?.phase;
+    return phase === undefined ? path.basename(vector[0] ?? '') : redactText(phase);
+}
+//# sourceMappingURL=watched-process.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watched-process.js","sourceRoot":"","sources":["../../../src/adapters/process/watched-process.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,wFAAwF;AACxF,mFAAmF;AAEnF,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAIzD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,OAAO,cAAc;IAEN;IACA;IAFnB,YACmB,KAAc,EACd,QAAkB;QADlB,UAAK,GAAL,KAAK,CAAS;QACd,aAAQ,GAAR,QAAQ,CAAU;IAClC,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,MAAyB,EAAE,UAAsB,EAAE;QAC3D,MAAM,OAAO,GACX,OAAO,CAAC,WAAW,KAAK,IAAI;YAC1B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE;YAC1B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACpB,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;gBAC/B,MAAM,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC;aAChC,CAAC,CAAC;QACT,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAc,EAAE,OAAyC;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,mFAAmF;AACnF,gCAAgC;AAChC,SAAS,OAAO,CAAC,MAAyB,EAAE,OAAmB;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;IACxC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAClF,CAAC"}

package/dist/adapters/prompter/terminal.js

@@ -0,0 +1,57 @@
+// Questions on the terminal, through stderr so stdout stays data. With
+// --no-input or without a TTY nothing waits: the question becomes an
+// INPUT_REQUIRED error that names the flag that would have answered it.
+// A question has the terminal to itself until it is answered.
+import readline from 'node:readline';
+import { DevkitError } from '../../domain/errors.js';
+export class TerminalPrompter {
+    noInput;
+    activity;
+    streams;
+    constructor(noInput, activity, streams = {
+        input: process.stdin,
+        output: process.stderr,
+    }) {
+        this.noInput = noInput;
+        this.activity = activity;
+        this.streams = streams;
+    }
+    async confirm(question, options = {}) {
+        const answer = await this.line(`${question} ${options.defaultYes === true ? '[Y/n]' : '[y/N]'} `, {
+            hint: 'Pass --yes to confirm without a prompt.',
+            commands: options.commands,
+        });
+        const normalized = answer.trim().toLowerCase();
+        if (normalized === '')
+            return options.defaultYes === true;
+        return normalized === 'y' || normalized === 'yes';
+    }
+    async ask(question) {
+        return this.line(`${question} `, { hint: 'This value has to come from a person.' });
+    }
+    async pause(message) {
+        await this.line(`${message} (press Enter to continue) `, {
+            hint: 'A manual step is waiting for a person.',
+        });
+    }
+    line(prompt, why) {
+        if (this.noInput || this.streams.input.isTTY !== true) {
+            return Promise.reject(new DevkitError('config', 'INPUT_REQUIRED', `A person has to answer: ${prompt.trim()}`, {
+                hint: why.hint,
+                nextSteps: why.commands === undefined
+                    ? ['Run the command again in a terminal.']
+                    : [...why.commands],
+            }));
+        }
+        const answered = this.activity.handover();
+        const rl = readline.createInterface({ input: this.streams.input, output: this.streams.output });
+        return new Promise((resolve) => {
+            rl.question(prompt, (answer) => {
+                rl.close();
+                answered();
+                resolve(answer);
+            });
+        });
+    }
+}
+//# sourceMappingURL=terminal.js.map

package/dist/adapters/prompter/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../../src/adapters/prompter/terminal.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,qEAAqE;AACrE,wEAAwE;AACxE,8DAA8D;AAE9D,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIrD,MAAM,OAAO,gBAAgB;IAER;IACA;IACA;IAHnB,YACmB,OAAgB,EAChB,QAAoC,EACpC,UAGb;QACF,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB;QARgB,YAAO,GAAP,OAAO,CAAS;QAChB,aAAQ,GAAR,QAAQ,CAA4B;QACpC,YAAO,GAAP,OAAO,CAMvB;IACA,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,UAA0B,EAAE;QAC1D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAC5B,GAAG,QAAQ,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,EACjE;YACE,IAAI,EAAE,yCAAyC;YAC/C,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CACF,CAAC;QACF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,IAAI,UAAU,KAAK,EAAE;YAAE,OAAO,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC;QAC1D,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,GAAG,EAAE,EAAE,IAAI,EAAE,uCAAuC,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,6BAA6B,EAAE;YACvD,IAAI,EAAE,wCAAwC;SAC/C,CAAC,CAAC;IACL,CAAC;IAEO,IAAI,CACV,MAAc,EACd,GAA+D;QAE/D,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACtD,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,2BAA2B,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE;gBACtF,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,SAAS,EACP,GAAG,CAAC,QAAQ,KAAK,SAAS;oBACxB,CAAC,CAAC,CAAC,sCAAsC,CAAC;oBAC1C,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;aACxB,CAAC,CACH,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAChG,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;gBAC7B,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,QAAQ,EAAE,CAAC;gBACX,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/adapters/reference/entry.js

@@ -0,0 +1,19 @@
+// Workspace reference providers return data only. Commands are handed to
+// the caller; incomplete templates never become executable-looking entries.
+import { DevkitError } from '../../domain/errors.js';
+import { placeholders, substitute, substituteAll } from '../../domain/template.js';
+export function referenceEntry(input) {
+    const { template, vars } = input;
+    const command = substituteAll(template.command, vars).vector;
+    const missing = [...new Set(command.flatMap(placeholders))];
+    if (missing.length > 0)
+        throw new DevkitError('config', 'PROVIDER_VAR_MISSING', `Missing provider variables: ${missing.join(', ')}`, {
+            nextSteps: ['fx manifest providers', 'fx manifest explain providers'],
+        });
+    return {
+        label: substitute(template.label, vars).text,
+        command,
+        ...(template.url === undefined ? {} : { url: substitute(template.url, vars).text }),
+    };
+}
+//# sourceMappingURL=entry.js.map

package/dist/adapters/reference/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../src/adapters/reference/entry.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,4EAA4E;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAa,MAAM,0BAA0B,CAAC;AAE9F,MAAM,UAAU,cAAc,CAAC,KAG9B;IACC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACjC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC;IAC7D,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QACpB,MAAM,IAAI,WAAW,CACnB,QAAQ,EACR,sBAAsB,EACtB,+BAA+B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACnD;YACE,SAAS,EAAE,CAAC,uBAAuB,EAAE,+BAA+B,CAAC;SACtE,CACF,CAAC;IACJ,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI;QAC5C,OAAO;QACP,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;KACpF,CAAC;AACJ,CAAC"}

package/dist/adapters/registry/npm-config.js

@@ -0,0 +1,62 @@
+import { runtimeRegistry } from './registry-policy.js';
+export class NpmRegistryLocator {
+    process;
+    env;
+    userHome;
+    locations = new Map();
+    constructor(process, env, userHome) {
+        this.process = process;
+        this.env = env;
+        this.userHome = userHome;
+    }
+    resolve(packageName) {
+        let location = this.locations.get(packageName);
+        if (!location) {
+            location = this.read(packageName);
+            this.locations.set(packageName, location);
+        }
+        return location;
+    }
+    async read(packageName) {
+        if (this.env.FX_REGISTRY !== undefined)
+            return {
+                registry: runtimeRegistry(packageName, this.env.FX_REGISTRY),
+                source: 'environment',
+            };
+        const scope = packageName.split('/')[0];
+        const key = `${scope}:registry`;
+        try {
+            const result = await this.process.run(['npm', 'config', 'get', key, 'registry', '--global', '--update-notifier=false'], {
+                cwd: this.userHome,
+                env: this.env,
+                timeoutMs: 2000,
+                sensitiveOutput: true,
+                diagnostic: { phase: 'npm registry configuration' },
+            });
+            if (result.code === 0) {
+                const lines = result.stdout.trim().split(/\r?\n/);
+                if (lines.length !== 2 ||
+                    !lines.some((line) => line.startsWith(`${key}=`)) ||
+                    !lines.some((line) => line.startsWith('registry=')))
+                    return { registry: null, source: 'unavailable' };
+                const value = (name) => {
+                    const line = lines.find((item) => item.startsWith(`${name}=`));
+                    const configured = line?.slice(name.length + 1).trim();
+                    return configured === undefined || configured === 'undefined' ? undefined : configured;
+                };
+                const scoped = value(key);
+                if (scoped !== undefined)
+                    return { registry: runtimeRegistry(packageName, scoped), source: 'npm_scope' };
+                const registry = value('registry');
+                if (registry !== undefined)
+                    return { registry: runtimeRegistry(packageName, registry), source: 'npm_default' };
+            }
+        }
+        catch {
+            // Startup and configuration failures must not break unrelated fx commands.
+        }
+        const registry = runtimeRegistry(packageName, undefined);
+        return { registry, source: registry === null ? 'unavailable' : 'distribution_default' };
+    }
+}
+//# sourceMappingURL=npm-config.js.map

package/dist/adapters/registry/npm-config.js.map

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

package/dist/adapters/registry/npm-http.js

@@ -0,0 +1,36 @@
+// Compatibility transport for an explicit FX_REGISTRY_TOKEN. Normal metadata
+// reads delegate configuration and authentication to npm.
+import { DevkitError } from '../../domain/errors.js';
+import { privateRegistry } from './registry-policy.js';
+export const TOKEN_ENV = 'FX_REGISTRY_TOKEN';
+export class NpmHttpRegistry {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async latest(packageName, signal) {
+        const { registry, timeoutMs, env } = this.options;
+        const token = privateRegistry(registry) ? env[TOKEN_ENV] : undefined;
+        const url = `${registry.replace(/\/+$/, '')}/${packageName.replace('/', '%2F')}`;
+        const response = await (this.options.fetch ?? fetch)(url, {
+            headers: {
+                Accept: 'application/vnd.npm.install-v1+json',
+                ...(token === undefined ? {} : { Authorization: `Bearer ${token}` }),
+            },
+            signal: AbortSignal.any([
+                AbortSignal.timeout(timeoutMs),
+                ...(signal === undefined ? [] : [signal]),
+            ]),
+        });
+        if (!response.ok) {
+            const category = response.status === 401 || response.status === 403 ? 'auth' : 'server';
+            throw new DevkitError(category, 'REGISTRY_HTTP_FAILED', `The configured registry responded ${response.status}`, { nextSteps: ['Check the configured registry and its npm token.', 'Retry later.'] });
+        }
+        const body = (await response.json());
+        const latest = body['dist-tags']?.latest;
+        if (latest === undefined || latest === '')
+            throw new DevkitError('parse', 'REGISTRY_RESPONSE_INVALID', 'Registry metadata has no dist-tags.latest', { nextSteps: ['Check the package metadata in the configured registry.'] });
+        return latest;
+    }
+}
+//# sourceMappingURL=npm-http.js.map

package/dist/adapters/registry/npm-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-http.js","sourceRoot":"","sources":["../../../src/adapters/registry/npm-http.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0DAA0D;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,CAAC,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAU7C,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,KAAK,CAAC,MAAM,CAAC,WAAmB,EAAE,MAAoB;QACpD,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAClD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;QACjF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,GAAG,EAAE;YACxD,OAAO,EAAE;gBACP,MAAM,EAAE,qCAAqC;gBAC7C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC;aACrE;YACD,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC;gBACtB,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;gBAC9B,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;aAC1C,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YACxF,MAAM,IAAI,WAAW,CACnB,QAAQ,EACR,sBAAsB,EACtB,qCAAqC,QAAQ,CAAC,MAAM,EAAE,EACtD,EAAE,SAAS,EAAE,CAAC,kDAAkD,EAAE,cAAc,CAAC,EAAE,CACpF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0C,CAAC;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QACzC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE;YACvC,MAAM,IAAI,WAAW,CACnB,OAAO,EACP,2BAA2B,EAC3B,2CAA2C,EAC3C,EAAE,SAAS,EAAE,CAAC,wDAAwD,CAAC,EAAE,CAC1E,CAAC;QACJ,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/adapters/registry/npm-registry.js

@@ -0,0 +1,89 @@
+// npm owns authentication, userconfig expansion and metadata transport. The
+// explicit legacy token still uses its existing HTTP path without exposing it to argv.
+import { mkdtemp, rm } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { NpmHttpRegistry, TOKEN_ENV } from './npm-http.js';
+import { privateRegistry, registryArguments } from './registry-policy.js';
+export class NpmRegistry {
+    process;
+    options;
+    constructor(process, options) {
+        this.process = process;
+        this.options = options;
+    }
+    async latest(packageName, signal) {
+        const { registry, env } = this.options;
+        const legacyTarget = privateRegistry(env.FX_REGISTRY);
+        if (env[TOKEN_ENV] &&
+            legacyTarget !== null &&
+            legacyTarget.replace(/\/+$/, '') === privateRegistry(registry)?.replace(/\/+$/, ''))
+            return new NpmHttpRegistry(this.options).latest(packageName, signal);
+        // npm may serve stale metadata on upstream failures. fx owns the persistent
+        // probe cache, so a live check must start without npm's previous response.
+        const cache = await mkdtemp(path.join(os.tmpdir(), 'fx-registry-'));
+        try {
+            return await this.query(packageName, cache, signal);
+        }
+        finally {
+            await rm(cache, { recursive: true, force: true });
+        }
+    }
+    async query(packageName, cache, signal) {
+        const { registry, env, userHome, timeoutMs } = this.options;
+        const result = await this.process
+            .run([
+            'npm',
+            'view',
+            packageName,
+            'dist-tags.latest',
+            '--json',
+            '--global',
+            '--cache',
+            cache,
+            ...registryArguments({ packageName, registry }),
+            '--prefer-online',
+            '--update-notifier=false',
+            '--fetch-retries=0',
+        ], {
+            cwd: userHome,
+            env,
+            timeoutMs,
+            signal,
+            sensitiveOutput: true,
+            diagnostic: { phase: 'npm package metadata' },
+        })
+            .catch(() => {
+            throw queryFailed();
+        });
+        let value;
+        try {
+            value = JSON.parse(result.stdout);
+        }
+        catch {
+            value = undefined;
+        }
+        if (result.code !== 0) {
+            const code = value?.error?.code;
+            throw queryFailed(code === 'E401' || code === 'E403' || code === 'EOTP');
+        }
+        if (typeof value !== 'string' || !value.trim())
+            throw new DevkitError('parse', 'REGISTRY_RESPONSE_INVALID', 'Registry metadata has no dist-tags.latest', {
+                nextSteps: ['Check the package metadata in the configured registry.'],
+            });
+        return value;
+    }
+}
+function queryFailed(auth = false) {
+    return new DevkitError(auth ? 'auth' : 'server', 'REGISTRY_HTTP_FAILED', auth
+        ? 'npm authentication was rejected by the package registry'
+        : 'npm could not query the package registry', {
+        nextSteps: [
+            auth
+                ? 'Check npm authentication for the selected registry, then retry.'
+                : 'Check npm availability, registry configuration and connectivity, then retry.',
+        ],
+    });
+}
+//# sourceMappingURL=npm-registry.js.map

package/dist/adapters/registry/npm-registry.js.map

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

package/dist/adapters/registry/registry-policy.js

@@ -0,0 +1,68 @@
+// @ts-check
+// Shared JavaScript keeps the same registry policy available to runtime adapters
+// and pre-build publication guards. Private coordinates come only from configuration.
+import { PUBLIC_REGISTRY, packageChannel } from '../../domain/distribution.js';
+/** @param {unknown} value @returns {string | null} */
+function registryUrl(value) {
+    if (typeof value !== 'string' || !value.trim())
+        return null;
+    try {
+        const url = new URL(value.trim());
+        return ['https:', 'http:'].includes(url.protocol) &&
+            !url.username &&
+            !url.password &&
+            !url.search &&
+            !url.hash
+            ? url.href
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** @param {unknown} value @returns {string | null} */
+export function privateRegistry(value) {
+    const registry = registryUrl(value);
+    if (!registry)
+        return null;
+    const host = new URL(registry).hostname.toLowerCase().replace(/\.+$/, '');
+    const publicHosts = ['npmjs.org', 'npmjs.com', 'yarnpkg.com'];
+    return publicHosts.some((domain) => host === domain || host.endsWith(`.${domain}`))
+        ? null
+        : registry;
+}
+/** @param {{packageName: string, registry: string, packageOnly?: boolean}} input @returns {string[]} */
+export function registryArguments({ packageName, registry, packageOnly = false }) {
+    const scope = /^(@[^/]+)\//.exec(packageName)?.[1];
+    return [
+        ...(packageOnly && scope ? [] : ['--registry', registry]),
+        ...(scope ? [`--${scope}:registry=${registry}`] : []),
+    ];
+}
+/** @param {string} packageName @param {unknown} configured */
+export function publicationRegistry(packageName, configured) {
+    if (packageChannel(packageName) === 'internal')
+        return privateRegistry(configured);
+    // Public artifacts must never be redirected to a private destination by ambient config.
+    return configured === undefined || isPublicRegistry(configured) ? PUBLIC_REGISTRY : null;
+}
+/** @param {string} packageName @param {unknown} configured */
+export function runtimeRegistry(packageName, configured) {
+    if (packageChannel(packageName) === 'internal')
+        return privateRegistry(configured);
+    if (configured === undefined || isPublicRegistry(configured))
+        return PUBLIC_REGISTRY;
+    return registryUrl(configured);
+}
+/** @param {unknown} value */
+function isPublicRegistry(value) {
+    if (typeof value !== 'string')
+        return false;
+    try {
+        return new URL(value.trim()).href === PUBLIC_REGISTRY;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=registry-policy.js.map

package/dist/adapters/registry/registry-policy.js.map

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

package/dist/adapters/task/lark-task/provider.js

@@ -0,0 +1,26 @@
+// Lark tasks: the to-dos assigned to the authorized user. fx reads the list and creates,
+// completes or assigns nothing.
+const MY_TASKS = ['task', '+get-my-tasks', '--format', 'json'];
+export const larkTaskProvider = {
+    id: 'lark-task',
+    capability: 'task',
+    reference: true,
+    tools: ['lark-cli'],
+    vars: [],
+    recipes: [
+        {
+            id: 'task-access',
+            tool: 'lark-cli',
+            perEnv: false,
+            kind: 'manual',
+            title: 'Authorize Lark tasks',
+            instructions: 'Use the lark-shared Skill to authorize the user identity for the task domain; a bot identity sees its own tasks, not the person’s.',
+            verify: { command: MY_TASKS },
+        },
+    ],
+    create: () => ({
+        label: 'Lark tasks assigned to the authorized user',
+        command: ['lark-cli', ...MY_TASKS],
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/task/lark-task/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/task/lark-task/provider.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,gCAAgC;AAKhC,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,EAAE,EAAE,WAAW;IACf,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC,UAAU,CAAC;IACnB,IAAI,EAAE,EAAE;IACR,OAAO,EAAE;QACP;YACE,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,sBAAsB;YAC7B,YAAY,EACV,oIAAoI;YACtI,MAAM,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE;SAC9B;KACF;IACD,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,4CAA4C;QACnD,OAAO,EAAE,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC;KACnC,CAAC;CACH,CAAC"}

package/dist/adapters/task/wecom-todo/provider.js

@@ -0,0 +1,29 @@
+// WeCom to-dos the authorized bot created or takes part in. The list is that bot's view,
+// not the company's.
+const TODOS = ['todo', 'list'];
+export const wecomTodoProvider = {
+    id: 'wecom-todo',
+    capability: 'task',
+    reference: true,
+    tools: ['wecom-cli'],
+    vars: [],
+    recipes: [
+        {
+            id: 'task-access',
+            tool: 'wecom-cli',
+            perEnv: false,
+            kind: 'manual',
+            title: 'Authorize WeCom to-do discovery',
+            instructions: 'Use the wecomcli-shared Skill to authorize wecom-cli. The to-do list covers what the authorized bot created or participates in.',
+            verify: {
+                command: TODOS,
+                json: { path: 'errcode', equals: 0, unmet: 'the WeCom API returned an error' },
+            },
+        },
+    ],
+    create: () => ({
+        label: 'WeCom to-dos visible to the authorized bot',
+        command: ['wecom-cli', ...TODOS],
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/task/wecom-todo/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/task/wecom-todo/provider.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,qBAAqB;AAKrB,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE/B,MAAM,CAAC,MAAM,iBAAiB,GAAmC;IAC/D,EAAE,EAAE,YAAY;IAChB,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,CAAC,WAAW,CAAC;IACpB,IAAI,EAAE,EAAE;IACR,OAAO,EAAE;QACP;YACE,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,iCAAiC;YACxC,YAAY,EACV,iIAAiI;YACnI,MAAM,EAAE;gBACN,OAAO,EAAE,KAAK;gBACd,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,4CAA4C;QACnD,OAAO,EAAE,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC;KACjC,CAAC;CACH,CAAC"}

package/dist/adapters/worklog/jira-worklog/provider.js

@@ -0,0 +1,56 @@
+// Worklogs kept in Jira, read through the family CLI. fx points at what is logged; entering
+// and correcting time stays with the person.
+import { familyService } from '../../family/service.js';
+import { referenceEntry } from '../../reference/entry.js';
+// `worklog search` requires a bounded window so a query cannot scan every visible issue,
+// and it answers for the authenticated user by default.
+const worklogSearch = (since) => [
+    'worklog',
+    'search',
+    '--project',
+    '{project}',
+    '--since',
+    since,
+    '--format',
+    'json',
+];
+export const jiraWorklogProvider = {
+    id: 'jira-worklog',
+    capability: 'worklog',
+    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 whose worklogs are read', required: true },
+    ],
+    service: (settings) => familyService('jira-cli', settings, '0.7.0'),
+    recipes: [
+        {
+            id: 'worklog-access',
+            tool: 'jira-cli',
+            perEnv: false,
+            kind: 'manual',
+            title: 'Connect Jira worklogs',
+            instructions: 'Configure jira-cli for the intended site and obtain access to the declared project.',
+            open: '{base_url}',
+            verify: { command: [...worklogSearch('24h'), '--limit', '1'] },
+        },
+    ],
+    create: (_deps, vars) => referenceEntry({
+        template: {
+            label: 'Recent worklogs in {project}',
+            command: [
+                'jira-cli',
+                ...(vars['context'] ? ['--use-context', vars['context']] : []),
+                ...worklogSearch('7d'),
+            ],
+            url: '{base_url}',
+        },
+        vars,
+    }),
+};
+//# sourceMappingURL=provider.js.map

package/dist/adapters/worklog/jira-worklog/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/adapters/worklog/jira-worklog/provider.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,6CAA6C;AAI7C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,yFAAyF;AACzF,wDAAwD;AACxD,MAAM,aAAa,GAAG,CAAC,KAAa,EAAqB,EAAE,CAAC;IAC1D,SAAS;IACT,QAAQ;IACR,WAAW;IACX,WAAW;IACX,SAAS;IACT,KAAK;IACL,UAAU;IACV,MAAM;CACP,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAmC;IACjE,EAAE,EAAE,cAAc;IAClB,UAAU,EAAE,SAAS;IACrB,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,qCAAqC,EAAE,QAAQ,EAAE,IAAI,EAAE;KACjF;IACD,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;IACnE,OAAO,EAAE;QACP;YACE,EAAE,EAAE,gBAAgB;YACpB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,uBAAuB;YAC9B,YAAY,EACV,qFAAqF;YACvF,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE;SAC/D;KACF;IACD,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,cAAc,CAAC;QACb,QAAQ,EAAE;YACR,KAAK,EAAE,8BAA8B;YACrC,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,aAAa,CAAC,IAAI,CAAC;aACvB;YACD,GAAG,EAAE,YAAY;SAClB;QACD,IAAI;KACL,CAAC;CACL,CAAC"}

package/dist/application/agent/cleanup.js

@@ -0,0 +1,4 @@
+// What unpicking an agent asks each resource owner to clean up. Unpicking is
+// global, so the same request reaches every registered workspace.
+export {};
+//# sourceMappingURL=cleanup.js.map

package/dist/application/agent/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../src/application/agent/cleanup.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,kEAAkE"}