@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/domain/manifest/tools.schema.js

@@ -0,0 +1,143 @@
+// Bundled tools and team patches share this schema. Tool fields may be omitted
+// for inheritance; nested declarations retain their own required fields.
+import * as z from 'zod';
+import { commandVector, jsonExpectation, minCli, schemaVersion } from './common.schema.js';
+export const INSTALLERS = ['npm', 'go', 'brew', 'manual'];
+export const installMethod = z
+    .strictObject({
+    via: z
+        .enum(INSTALLERS)
+        .describe('package manager: npm, go, brew, or manual for a tool installed by hand'),
+    spec: z
+        .string()
+        .optional()
+        .describe('package the manager is asked for; an npm method may omit it and inherit defaults.npm_scope'),
+    registry: z
+        .string()
+        .optional()
+        .describe('npm registry to install from, when not the default one'),
+})
+    .describe('one way to install a tool');
+export const skillCommand = z
+    .strictObject({
+    command: commandVector.describe('arguments that install the companion Skill; empty means it ships none'),
+    agent_flag: z
+        .string()
+        .optional()
+        .describe('flag naming one target agent, repeated per agent; absent means the tool chooses'),
+    dir_flag: z
+        .string()
+        .optional()
+        .describe('install once per selected global Skill directory when agent_flag is absent'),
+})
+    .describe('how a tool installs its own companion Skill');
+export const authCommand = z
+    .strictObject({
+    command: commandVector.describe('arguments that report credential status; empty means no credentials are needed'),
+    docs: z.string().optional().describe('where signing in is documented'),
+})
+    .describe('how a tool reports whether its credentials work');
+export const verifyCheck = z
+    .union([
+    z.strictObject({
+        command: commandVector.describe('tool arguments whose success proves the step'),
+        json: jsonExpectation
+            .optional()
+            .describe('a JSON result that must also match; exit zero alone is otherwise sufficient'),
+    }),
+    z.strictObject({
+        file: z
+            .string()
+            .describe('a path that must exist; relative to the workspace root, with ~ referring to the user home'),
+    }),
+    z.strictObject({
+        provider: z.literal('whoami').describe('ask the bound provider who the user is'),
+    }),
+])
+    .describe('how the step is verified; doctor runs the same check');
+export const setupStep = z
+    .strictObject({
+    id: z.string().min(1).describe('stable step id, referenced by local.setup and doctor'),
+    kind: z
+        .enum(['run', 'manual', 'file'])
+        .describe('run: fx executes it; manual: a person does it; file: a person puts a file in place'),
+    phase: z
+        .enum(['prepare', 'authenticate'])
+        .optional()
+        .describe('Required for run steps: prepare is non-interactive local setup; authenticate requires personal sign-in'),
+    title: z.string().describe('one line shown before the step'),
+    open: z.string().optional().describe('URL the person is pointed at'),
+    instructions: z.string().optional().describe('what to do, in markdown'),
+    run: commandVector.optional().describe('for kind run: the tool arguments fx executes'),
+    expects: z
+        .strictObject({ path: z.string().describe('the file the person must put in place') })
+        .optional()
+        .describe('for kind file: what must exist afterwards'),
+    verify: verifyCheck,
+    requires: z.array(z.string()).optional().describe('ids of steps that must pass first'),
+})
+    .describe('one setup step the team adds beyond the provider recipe');
+export const toolSchema = z
+    .strictObject({
+    name: z.string().min(1).describe("the tool's name, and by default its executable"),
+    binary: z.string().optional().describe('executable to run; defaults to the name'),
+    desc: z.string().optional().describe('one-line description shown in listings'),
+    docs: z.string().optional().describe('where the tool documents itself'),
+    min_version: z
+        .string()
+        .optional()
+        .describe('lowest version that carries the features this workspace relies on'),
+    required: z
+        .boolean()
+        .optional()
+        .describe('whether the workspace is unusable without this tool'),
+    enabled: z
+        .boolean()
+        .optional()
+        .describe('false keeps the entry but marks the tool as no longer used by the team'),
+    version_args: commandVector
+        .optional()
+        .describe('arguments that make this tool print its version; defaults to defaults.version_args'),
+    install_on_init: z
+        .boolean()
+        .optional()
+        .describe('install this tool if missing during fx init, after command trust approval; default false'),
+    install: z
+        .array(installMethod)
+        .optional()
+        .describe('how to install this tool, in order of preference; replaces defaults.install'),
+    skill: skillCommand.optional(),
+    auth: authCommand.optional(),
+    setup: z.array(setupStep).optional().describe('manual or team-specific setup steps'),
+})
+    .describe('one companion tool');
+export const toolsSchema = z
+    .strictObject({
+    schema_version: schemaVersion,
+    min_cli: minCli,
+    defaults: z
+        .strictObject({
+        version_args: commandVector
+            .optional()
+            .describe('arguments that make a tool print its version'),
+        npm_scope: z
+            .string()
+            .optional()
+            .describe("npm scope prepended to a tool's name when an npm method gives no spec"),
+        install: z
+            .array(installMethod)
+            .optional()
+            .describe('how to install a tool, in order of preference'),
+        skill: skillCommand.optional(),
+        auth: authCommand.optional(),
+        install_on_init: z
+            .boolean()
+            .optional()
+            .describe('install every tool of this workspace during fx init unless it opts out'),
+    })
+        .optional()
+        .describe('conventions every tool inherits unless it overrides them'),
+    tools: z.array(toolSchema).describe('the companion CLIs this workspace expects'),
+})
+    .describe('the companion toolchain: which CLIs the workspace uses and how to install, verify and set them up');
+//# sourceMappingURL=tools.schema.js.map

package/dist/domain/manifest/tools.schema.js.map

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

package/dist/domain/manifest/types.js

@@ -0,0 +1,4 @@
+// The manifest types every later layer consumes, inferred from the schemas
+// so a document's shape is defined exactly once.
+export const KINDS = ['workspace', 'environments', 'tools', 'members', 'harness', 'local'];
+//# sourceMappingURL=types.js.map

package/dist/domain/manifest/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/manifest/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,iDAAiD;AA8BjD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC"}

package/dist/domain/manifest/versioning.js

@@ -0,0 +1,64 @@
+// Schema negotiation. There is no embedded snapshot to fall back on, so every mismatch
+// is fatal and the only cure is to upgrade fx or migrate the manifest. A development
+// build of fx skips the version floor: it is newer than any release by definition.
+import { DevkitError } from '../errors.js';
+import { atLeast, isRelease, isSemver } from '../semver.js';
+export const SUPPORTED = {
+    workspace: [1, 2],
+    environments: [1, 2],
+    tools: [3],
+    harness: [2],
+    members: [1],
+};
+export function negotiate(header, cliVersion, supported) {
+    const schema = Number.isInteger(header.schema_version)
+        ? header.schema_version
+        : undefined;
+    const minCli = typeof header.min_cli === 'string' ? header.min_cli : undefined;
+    return { schema, minCli, failure: failureOf(schema, minCli, cliVersion, supported) };
+}
+function failureOf(schema, minCli, cliVersion, supported) {
+    if (schema === undefined)
+        return undefined;
+    if (schema < Math.min(...supported))
+        return 'schema_too_old';
+    if (schema > Math.max(...supported))
+        return 'schema_too_new';
+    if (minCli !== undefined &&
+        isSemver(minCli) &&
+        isRelease(cliVersion) &&
+        !atLeast(cliVersion, minCli))
+        return 'cli_too_old';
+    return undefined;
+}
+const UPGRADE_STEPS = ['fx self update --dry-run', 'fx --version'];
+export function negotiationError(kind, n, cliVersion) {
+    if (n.failure === undefined)
+        return undefined;
+    const code = `MANIFEST_${n.failure.toUpperCase()}`;
+    const message = {
+        schema_too_old: `${kind} manifest uses schema version ${n.schema}, which fx ${cliVersion} no longer reads`,
+        schema_too_new: `${kind} manifest uses schema version ${n.schema}, which fx ${cliVersion} does not understand yet`,
+        cli_too_old: `${kind} manifest requires fx ${n.minCli} or newer, but this is ${cliVersion}`,
+    }[n.failure];
+    const nextSteps = n.failure === 'schema_too_old'
+        ? [
+            'Ask the manifest maintainers to migrate it to a supported schema version.',
+            ...UPGRADE_STEPS,
+        ]
+        : UPGRADE_STEPS;
+    const toolsMigration = kind === 'tools' && n.failure === 'schema_too_old';
+    return new DevkitError('config', code, message, {
+        hint: toolsMigration
+            ? 'Use schema_version: 3 in tools.yaml. Each kind: run setup step needs phase: prepare for local non-interactive setup or phase: authenticate for personal sign-in.'
+            : 'The manifest and this fx release disagree about the document format.',
+        nextSteps: toolsMigration
+            ? [
+                'fx manifest schema --kind tools',
+                'fx manifest explain --kind tools "tools[].setup[].phase"',
+                'Update the source declaration and retry the original initialization.',
+            ]
+            : nextSteps,
+    });
+}
+//# sourceMappingURL=versioning.js.map

package/dist/domain/manifest/versioning.js.map

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

package/dist/domain/manifest/workspace.schema.js

@@ -0,0 +1,185 @@
+// manifest/workspace.yaml: projects, repositories, defaults and the workspace-scoped
+// provider bindings. Schema 1 documents have no `providers` and carry the git host under
+// `defaults.host`; both spellings are accepted so an existing manifest loads unchanged.
+import * as z from 'zod';
+import { coordinate, minCli, schemaVersion } from './common.schema.js';
+import { serviceSchema } from './service.schema.js';
+export const providerBinding = z
+    .strictObject({
+    provider: z.string().min(1).describe('provider id, e.g. bitbucket-cli'),
+    service: serviceSchema.optional(),
+    vars: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe('variables the provider needs, e.g. host, web, space'),
+})
+    .describe('which provider fulfils a capability, and with what variables');
+export const repoObs = z
+    .strictObject({
+    svc: z
+        .string()
+        .optional()
+        .describe('service name substituted for {svc}; defaults to the repository name without its prefix'),
+    covered: z
+        .boolean()
+        .optional()
+        .describe('false marks a service deliberately outside observability coverage'),
+    note: z
+        .string()
+        .optional()
+        .describe('why this repository deviates; carried into every rendering'),
+    overrides: z
+        .record(z.string(), z.record(z.string(), coordinate))
+        .optional()
+        .describe('per-platform, per-environment exceptions to the derived coordinates'),
+})
+    .describe('deviations from the observability patterns declared in environments.yaml');
+const releaseCi = z
+    .strictObject({
+    source_env: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('environment whose ci coordinate is the job building the source branch'),
+    target_env: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('environment whose ci coordinate is the job building the target branch'),
+})
+    .describe('which environments name the ci jobs of the source and target branches');
+export const releaseSchema = z
+    .strictObject({
+    source: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('branch a release is cut from; defaults to defaults.branch'),
+    targets: z
+        .array(z.string().min(1))
+        .min(1)
+        .optional()
+        .describe('candidate branches a release lands on, the first one a repository has wins; defaults to main, master'),
+    env: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('environment whose error tracker counts for the errors check; unset means errors are not checked'),
+    since: z
+        .string()
+        .optional()
+        .describe('how far back a new unresolved error counts, e.g. 14d or 48h; defaults to 14d'),
+    ci: releaseCi.optional(),
+    bots: z
+        .array(z.string())
+        .optional()
+        .describe('commit author names the merge check ignores, such as a CI account'),
+})
+    .describe('what a release is in this workspace: its branches, the environment whose errors count, and its ci jobs');
+export const repoRelease = z
+    .strictObject({
+    covered: z
+        .boolean()
+        .optional()
+        .describe('false keeps this repository off the release checklist'),
+    source: z.string().min(1).optional().describe('branch this repository releases from'),
+    target: z.string().min(1).optional().describe('branch this repository releases to'),
+    ci: releaseCi.optional(),
+    note: z
+        .string()
+        .optional()
+        .describe('why this repository deviates; carried into every rendering'),
+})
+    .describe('how this repository deviates from the workspace release policy');
+export const repoSchema = z
+    .strictObject({
+    name: z
+        .string()
+        .min(1)
+        .describe('repository name; also the fork name under the personal namespace'),
+    path: z
+        .string()
+        .optional()
+        .describe('checkout path relative to the workspace root; defaults to the name'),
+    desc: z.string().optional().describe('one-line description shown in listings'),
+    aka: z
+        .array(z.string().refine((value) => value.trim().length > 0, 'alias must not be blank'))
+        .optional()
+        .describe('exact aliases used for read-only repository discovery'),
+    links: z
+        .record(z.string().min(1), z.string().min(1))
+        .optional()
+        .describe('named reference strings shown by repo show; never fetched or executed'),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe('free-form labels for filtering; a repository may carry several'),
+    branch: z.string().optional().describe('branch to track; defaults to defaults.branch'),
+    project: z
+        .string()
+        .optional()
+        .describe('code-host project holding this repository; defaults to defaults.upstream_project'),
+    upstream: z
+        .string()
+        .optional()
+        .describe('complete upstream URL, replacing the one derived from host, project and name'),
+    obs: repoObs.optional(),
+    release: repoRelease.optional(),
+})
+    .describe('one repository of the workspace');
+export const workspaceSchema = z
+    .strictObject({
+    schema_version: schemaVersion,
+    min_cli: minCli,
+    providers: z
+        .record(z.string(), providerBinding)
+        .optional()
+        .describe('workspace-scoped capability bindings, keyed by capability'),
+    defaults: z
+        .strictObject({
+        host: z
+            .string()
+            .optional()
+            .describe('git host prefix, e.g. ssh://git@git.example.com (schema 1; schema 2 puts it in providers.code-host.vars.host)'),
+        upstream_project: z
+            .string()
+            .optional()
+            .describe('code-host project holding the official repositories'),
+        origin_pattern: z
+            .string()
+            .optional()
+            .describe('legacy import hint for fork naming; actual fork URLs are owned by the code-host provider'),
+        branch: z.string().optional().describe('branch to track when a repository names none'),
+    })
+        .default({})
+        .describe('values every repository inherits unless it overrides them'),
+    projects: z
+        .record(z.string(), z
+        .strictObject({
+        label: z.string().optional().describe('human-readable name'),
+        contact: z
+            .string()
+            .optional()
+            .describe("where to request access to this project's repositories"),
+    })
+        .describe('one code-host project'))
+        .optional()
+        .describe('code-host projects this workspace draws on, and who grants access to each'),
+    repos: z.array(repoSchema).describe('the repositories that make up the workspace'),
+    go: z
+        .strictObject({
+        workspace: z
+            .boolean()
+            .optional()
+            .describe('true keeps a go.work at the workspace root over every Go module checked out there'),
+    })
+        .optional()
+        .describe('how fx treats the Go modules among the repositories'),
+    release: releaseSchema.optional(),
+    workflows: z
+        .array(z.unknown())
+        .optional()
+        .describe('reserved for team workflows; parsed and ignored by this version'),
+})
+    .describe('the workspace: which repositories exist, how they are reached, and who provides what');
+//# sourceMappingURL=workspace.schema.js.map

package/dist/domain/manifest/workspace.schema.js.map

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

package/dist/domain/members/owners.js

@@ -0,0 +1,47 @@
+// Who is responsible for what, read off the ownership matrix. "all" is a
+// role's way of saying the whole team and is kept as written, never
+// expanded into names.
+export function ownersOf(members, repo) {
+    const ref = (id) => {
+        const person = members.people.find((p) => p.id === id);
+        return { id, name: person?.display ?? null, email: person?.email ?? null };
+    };
+    const owners = [];
+    for (const area of members.areas ?? []) {
+        for (const scenario of area.scenarios ?? []) {
+            if (!(scenario.repos ?? []).includes(repo))
+                continue;
+            owners.push({
+                area: area.group,
+                lead: area.lead === undefined ? null : ref(area.lead),
+                scenario: scenario.name,
+                devLead: scenario.dev_lead === undefined ? null : ref(scenario.dev_lead),
+                roles: Object.fromEntries(Object.entries(scenario.roles ?? {}).map(([role, ids]) => [role, ids.map(ref)])),
+            });
+        }
+    }
+    return owners;
+}
+export function areasOf(members, personId) {
+    return (members.areas ?? [])
+        .filter((area) => peopleOfArea(members, area.group).includes(personId))
+        .map((area) => area.group);
+}
+export function peopleOfArea(members, group) {
+    const area = (members.areas ?? []).find((a) => a.group === group);
+    if (area === undefined)
+        return [];
+    const ids = new Set();
+    if (area.lead !== undefined)
+        ids.add(area.lead);
+    for (const scenario of area.scenarios ?? []) {
+        if (scenario.dev_lead !== undefined)
+            ids.add(scenario.dev_lead);
+        for (const people of Object.values(scenario.roles ?? {}))
+            for (const id of people)
+                if (id !== 'all')
+                    ids.add(id);
+    }
+    return [...ids];
+}
+//# sourceMappingURL=owners.js.map

package/dist/domain/members/owners.js.map

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

package/dist/domain/members/resolve.js

@@ -0,0 +1,57 @@
+// Who is meant by a name. Identifiers are matched exactly and in a fixed
+// order of trust — an email address is unambiguous, a display name is not —
+// and only when nothing matches exactly does spelling distance get a say.
+import { nearest } from '../fuzzy.js';
+const ORDER = ['email', 'id', 'account', 'display', 'git_name'];
+export function findPeople(members, query) {
+    const q = query.trim().toLowerCase();
+    const matches = [];
+    for (const person of members.people) {
+        const hit = exactMatch(person, q);
+        if (hit !== undefined)
+            matches.push(hit);
+    }
+    if (matches.length > 0)
+        return matches.sort((a, b) => ORDER.indexOf(a.matchedBy) - ORDER.indexOf(b.matchedBy));
+    const candidates = members.people.flatMap((p) => [
+        p.id,
+        ...(p.display === undefined ? [] : [p.display]),
+    ]);
+    const near = nearest(q, candidates.map((c) => c.toLowerCase()), 2);
+    if (near === undefined)
+        return [];
+    const person = members.people.find((p) => p.id.toLowerCase() === near || p.display?.toLowerCase() === near);
+    return person === undefined ? [] : [{ person, matchedBy: 'fuzzy', via: near }];
+}
+function exactMatch(person, q) {
+    if (person.email?.toLowerCase() === q)
+        return { person, matchedBy: 'email' };
+    if (person.id.toLowerCase() === q)
+        return { person, matchedBy: 'id' };
+    for (const [system, account] of Object.entries(person.accounts ?? {})) {
+        if (handlesOf(account).some((h) => h.toLowerCase() === q))
+            return { person, matchedBy: 'account', via: system };
+    }
+    if (person.display !== undefined && person.display.toLowerCase().includes(q))
+        return { person, matchedBy: 'display' };
+    const gitName = (person.git_names ?? []).find((n) => n.toLowerCase() === q);
+    if (gitName !== undefined)
+        return { person, matchedBy: 'git_name', via: gitName };
+    return undefined;
+}
+function handlesOf(account) {
+    if (typeof account === 'string')
+        return [account];
+    return [account.username, account.id].filter((h) => h !== undefined);
+}
+// A commit author is attributed only on an exact git name or display
+// name; there is no fuzzy step, and two people sharing a name means nobody.
+export function findByGitName(members, name) {
+    const q = name.trim().toLowerCase();
+    const hits = members.people.filter((p) => (p.git_names ?? []).some((n) => n.toLowerCase() === q) || p.display?.toLowerCase() === q);
+    return hits.length === 1 ? hits[0] : undefined;
+}
+export function suggestPerson(members, query) {
+    return nearest(query, members.people.flatMap((p) => [p.id, ...(p.display === undefined ? [] : [p.display])]));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/domain/members/resolve.js.map

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

package/dist/domain/obs/confidence.js

@@ -0,0 +1,11 @@
+// How well a coordinate is known, from best to worst. Combining declared
+// confidences takes the weakest: a coordinate is only as trustworthy as
+// its least certain part.
+import { CONFIDENCE } from '../manifest/common.schema.js';
+export function weakest(declared) {
+    const known = declared.filter((c) => c !== undefined);
+    if (known.length === 0)
+        return 'derived';
+    return known.reduce((worst, c) => CONFIDENCE.indexOf(c) > CONFIDENCE.indexOf(worst) ? c : worst);
+}
+//# sourceMappingURL=confidence.js.map

package/dist/domain/obs/confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../../src/domain/obs/confidence.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,0BAA0B;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI1D,MAAM,UAAU,OAAO,CAAC,QAA6C;IACnE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACvE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAC/B,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAC9D,CAAC;AACJ,CAAC"}