@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/cli/commands/workspace/list.js

@@ -0,0 +1,20 @@
+import { discoverWorkspaces, WORKSPACE_COLUMNS } from '../../../application/workspace/discover.js';
+import { FxCommand } from '../../base.js';
+export default class WorkspaceList extends FxCommand {
+    static description = 'List registered workspaces from any directory, including unavailable roots and manifests';
+    static flags = {};
+    async run() {
+        await this.parse(WorkspaceList);
+        const { items, has_more: _hasMore, ...trailer } = await discoverWorkspaces({
+            ...this.resolveInput(),
+            bundledTools: this.container.bundledTools,
+            providers: this.container.providers,
+            cliVersion: this.config.version,
+        });
+        this.renderer.list(items, {
+            columns: WORKSPACE_COLUMNS,
+            trailer,
+        });
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/workspace/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/cli/commands/workspace/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,SAAS;IAClD,MAAM,CAAU,WAAW,GACzB,0FAA0F,CAAC;IAC7F,MAAM,CAAU,KAAK,GAAG,EAAE,CAAC;IAC3B,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAChC,MAAM,EACJ,KAAK,EACL,QAAQ,EAAE,QAAQ,EAClB,GAAG,OAAO,EACX,GAAG,MAAM,kBAAkB,CAAC;YAC3B,GAAG,IAAI,CAAC,YAAY,EAAE;YACtB,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY;YACzC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS;YACnC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAChC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE;YACxB,OAAO,EAAE,iBAAiB;YAC1B,OAAO;SACR,CAAC,CAAC;IACL,CAAC"}

package/dist/cli/commands/workspace/rebind.js

@@ -0,0 +1,33 @@
+import { Flags } from '@oclif/core';
+import { manifestSourceFor } from '../../../composition/manifest-sources.js';
+import { workspaceManagement } from '../../../composition/workspace-management.js';
+import { FxCommand } from '../../base.js';
+import { dryRunFlag, requiredArgument, writeIntent } from '../../flags.js';
+import { readStdin } from '../../stdin.js';
+export default class WorkspaceRebind extends FxCommand {
+    static description = 'Replace a registered manifest source with a validated staged source, preserving identity and local selections and retaining the previous source as a backup';
+    static args = {
+        name: requiredArgument('registered workspace name'),
+    };
+    static flags = {
+        from: Flags.string({
+            required: true,
+            description: 'new manifest Git URL, directory or - for stdin',
+        }),
+        'dry-run': dryRunFlag,
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkspaceRebind);
+        const source = await manifestSourceFor(flags.from, this.container, readStdin);
+        this.renderer.record(await workspaceManagement({
+            ...this.harnessInput(),
+            commandShell: this.commandShell,
+        }).execute({
+            name: args.name,
+            action: 'rebind',
+            source,
+            ...writeIntent(flags, this.posture),
+        }));
+    }
+}
+//# sourceMappingURL=rebind.js.map

package/dist/cli/commands/workspace/rebind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebind.js","sourceRoot":"","sources":["../../../../src/cli/commands/workspace/rebind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,SAAS;IACpD,MAAM,CAAU,WAAW,GACzB,6JAA6J,CAAC;IAChK,MAAM,CAAU,IAAI,GAAG;QACrB,IAAI,EAAE,gBAAgB,CAAC,2BAA2B,CAAC;KACpD,CAAC;IACF,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,gDAAgD;SAC9D,CAAC;QACF,SAAS,EAAE,UAAU;KACtB,CAAC;IACF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9E,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,MAAM,mBAAmB,CAAC;YACxB,GAAG,IAAI,CAAC,YAAY,EAAE;YACtB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC,OAAO,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM;YACN,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;SACpC,CAAC,CACH,CAAC;IACJ,CAAC"}

package/dist/cli/commands/workspace/relocate.js

@@ -0,0 +1,21 @@
+import { workspaceManagement } from '../../../composition/workspace-management.js';
+import { FxCommand } from '../../base.js';
+import { dryRunFlag, requiredArgument, writeIntent } from '../../flags.js';
+export default class WorkspaceRelocate extends FxCommand {
+    static description = 'Point a workspace identity at its moved directory, preserving personal selections and checkout files; run sync afterwards to regenerate owned resources';
+    static args = {
+        name: requiredArgument('registered workspace name'),
+        dir: requiredArgument('existing directory after moving the workspace'),
+    };
+    static flags = { 'dry-run': dryRunFlag };
+    async run() {
+        const { args, flags } = await this.parse(WorkspaceRelocate);
+        this.renderer.record(await workspaceManagement(this.harnessInput()).execute({
+            name: args.name,
+            action: 'relocate',
+            root: args.dir,
+            ...writeIntent(flags, this.posture),
+        }));
+    }
+}
+//# sourceMappingURL=relocate.js.map

package/dist/cli/commands/workspace/relocate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relocate.js","sourceRoot":"","sources":["../../../../src/cli/commands/workspace/relocate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE3E,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,SAAS;IACtD,MAAM,CAAU,WAAW,GACzB,yJAAyJ,CAAC;IAC5J,MAAM,CAAU,IAAI,GAAG;QACrB,IAAI,EAAE,gBAAgB,CAAC,2BAA2B,CAAC;QACnD,GAAG,EAAE,gBAAgB,CAAC,+CAA+C,CAAC;KACvE,CAAC;IACF,MAAM,CAAU,KAAK,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IAClD,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC5D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,MAAM,mBAAmB,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC;YACrD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,IAAI,CAAC,GAAG;YACd,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;SACpC,CAAC,CACH,CAAC;IACJ,CAAC"}

package/dist/cli/commands/workspace/show.js

@@ -0,0 +1,22 @@
+import { showWorkspace } from '../../../application/workspace/discover.js';
+import { FxCommand } from '../../base.js';
+import { argument } from '../../flags.js';
+export default class WorkspaceShow extends FxCommand {
+    static description = 'Show registered identity, selection provenance, source and readiness without requiring a healthy manifest';
+    static args = {
+        name: argument('registered name; defaults to current workspace resolution'),
+    };
+    static flags = {};
+    async run() {
+        const { args } = await this.parse(WorkspaceShow);
+        const resolve = this.resolveInput();
+        this.renderer.record(await showWorkspace({
+            ...resolve,
+            name: args.name ?? resolve.name,
+            bundledTools: this.container.bundledTools,
+            providers: this.container.providers,
+            cliVersion: this.config.version,
+        }));
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/cli/commands/workspace/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../../src/cli/commands/workspace/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,SAAS;IAClD,MAAM,CAAU,WAAW,GACzB,2GAA2G,CAAC;IAC9G,MAAM,CAAU,IAAI,GAAG;QACrB,IAAI,EAAE,QAAQ,CAAC,2DAA2D,CAAC;KAC5E,CAAC;IACF,MAAM,CAAU,KAAK,GAAG,EAAE,CAAC;IAC3B,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,MAAM,aAAa,CAAC;YAClB,GAAG,OAAO;YACV,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;YAC/B,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY;YACzC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS;YACnC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;SAChC,CAAC,CACH,CAAC;IACJ,CAAC"}

package/dist/cli/commands/workspace/unregister.js

@@ -0,0 +1,19 @@
+import { workspaceManagement } from '../../../composition/workspace-management.js';
+import { FxCommand } from '../../base.js';
+import { dryRunFlag, requiredArgument, writeIntent } from '../../flags.js';
+export default class WorkspaceUnregister extends FxCommand {
+    static description = 'Stop managing one workspace: retire owned project resources, archive personal metadata and preserve business checkouts and global tools';
+    static args = {
+        name: requiredArgument('registered workspace name'),
+    };
+    static flags = { 'dry-run': dryRunFlag };
+    async run() {
+        const { args, flags } = await this.parse(WorkspaceUnregister);
+        this.renderer.record(await workspaceManagement(this.harnessInput()).execute({
+            name: args.name,
+            action: 'unregister',
+            ...writeIntent(flags, this.posture),
+        }));
+    }
+}
+//# sourceMappingURL=unregister.js.map

package/dist/cli/commands/workspace/unregister.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unregister.js","sourceRoot":"","sources":["../../../../src/cli/commands/workspace/unregister.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE3E,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,SAAS;IACxD,MAAM,CAAU,WAAW,GACzB,yIAAyI,CAAC;IAC5I,MAAM,CAAU,IAAI,GAAG;QACrB,IAAI,EAAE,gBAAgB,CAAC,2BAA2B,CAAC;KACpD,CAAC;IACF,MAAM,CAAU,KAAK,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IAClD,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClB,MAAM,mBAAmB,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC;YACrD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,YAAY;YACpB,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;SACpC,CAAC,CACH,CAAC;IACJ,CAAC"}

package/dist/cli/completion.js

@@ -0,0 +1,217 @@
+// Generate shell completion from command and flag metadata. Scanners retain the
+// command after positional arguments and skip option values before routing words.
+import { DevkitError } from '../domain/errors.js';
+import { nearest } from '../domain/fuzzy.js';
+export const SHELLS = ['bash', 'zsh', 'fish', 'powershell'];
+export function completionFlags(definitions) {
+    return Object.entries(definitions).flatMap(([name, flag]) => {
+        if (flag.hidden)
+            return [];
+        const names = [
+            `--${name}`,
+            ...(flag.allowNo ? [`--no-${name}`] : []),
+            ...(flag.char ? [`-${flag.char}`] : []),
+        ];
+        return names.map((spelling) => ({
+            name: spelling,
+            takesValue: flag.type === 'option',
+            options: flag.options ?? [],
+        }));
+    });
+}
+export function completionScript(shell, commands, globals) {
+    if (!SHELLS.includes(shell)) {
+        const suggestion = nearest(shell, SHELLS);
+        throw new DevkitError('usage', 'SHELL_UNKNOWN', `"${shell}" is not a shell fx can complete`, {
+            hint: suggestion === undefined
+                ? `Choose one of ${SHELLS.join(', ')}.`
+                : `Did you mean "${suggestion}"?`,
+            nextSteps: SHELLS.map((s) => `fx completion ${s}`),
+        });
+    }
+    const ids = ['', ...new Set(commands.flatMap(({ id }) => [id.split(' ')[0], id]))];
+    const entries = ids.map((id) => ({
+        id,
+        children: childCommands(commands.filter((command) => command.aliasOf === undefined), id),
+        routes: childCommands(commands, id),
+        flags: [
+            ...globals,
+            ...(commands.find((command) => command.id === id)?.flags ?? []),
+            { name: '--help', takesValue: false, options: [] },
+            { name: '-h', takesValue: false, options: [] },
+        ],
+    }));
+    if (shell === 'powershell')
+        return powershell(entries);
+    if (shell === 'fish')
+        return fish(entries);
+    return posix(shell, entries);
+}
+function childCommands(commands, id) {
+    return [
+        ...new Set(commands.flatMap((command) => {
+            if (id === '')
+                return [command.id.split(' ')[0]];
+            return command.id.startsWith(`${id} `) ? [command.id.slice(id.length + 1)] : [];
+        })),
+    ];
+}
+const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+function posixScanner(entries) {
+    const transitions = entries.flatMap((entry) => entry.routes.map((child) => `      ${quote(`${entry.id}:${child}`)}) fx_cmd=${quote([entry.id, child].filter(Boolean).join(' '))} ;;`));
+    const options = entries.flatMap((entry) => entry.flags
+        .filter((flag) => flag.takesValue)
+        .map((flag) => `      ${quote(`${entry.id}:${flag.name}`)}) fx_pending=${quote(flag.name)} ;;`));
+    const values = entries.flatMap((entry) => entry.flags
+        .filter((flag) => flag.options.length)
+        .map((flag) => `      ${quote(`${entry.id}:${flag.name}`)}) fx_candidates=${quote(flag.options.join(' '))} ;;`));
+    const flags = entries.map((entry) => `      ${quote(entry.id)}) fx_candidates=${quote(entry.flags.map((flag) => flag.name).join(' '))} ;;`);
+    const children = entries.map((entry) => `      ${quote(entry.id)}) fx_candidates=${quote(entry.children.join(' '))} ;;`);
+    return [
+        '_fx_candidates() {',
+        '  local fx_cmd="" fx_pending="" fx_token',
+        '  fx_candidates=""',
+        '  for fx_token in "$@"; do',
+        '    if [[ -n "$fx_pending" ]]; then fx_pending=""; continue; fi',
+        '    if [[ "$fx_token" == -- ]]; then return; fi',
+        '    case "$fx_cmd:$fx_token" in',
+        ...options,
+        '    esac',
+        '    if [[ "$fx_token" == -* ]]; then continue; fi',
+        '    case "$fx_cmd:$fx_token" in',
+        ...transitions,
+        '    esac',
+        '  done',
+        '  if [[ -n "$fx_pending" ]]; then',
+        '    case "$fx_cmd:$fx_pending" in',
+        ...values,
+        '    esac',
+        '  elif [[ "$fx_current" == -* ]]; then',
+        '    case "$fx_cmd" in',
+        ...flags,
+        '    esac',
+        '  else',
+        '    case "$fx_cmd" in',
+        ...children,
+        '    esac',
+        '  fi',
+        '}',
+    ];
+}
+function posix(shell, entries) {
+    const common = posixScanner(entries);
+    if (shell === 'bash')
+        return [
+            '# fx bash completion: source this file.',
+            ...common,
+            '_fx() {',
+            '  local fx_current="${COMP_WORDS[COMP_CWORD]}" fx_candidates',
+            '  _fx_candidates "${COMP_WORDS[@]:1:COMP_CWORD-1}"',
+            '  COMPREPLY=( $(compgen -W "$fx_candidates" -- "$fx_current") )',
+            '}',
+            'complete -F _fx fx',
+            '',
+        ].join('\n');
+    return [
+        '#compdef fx',
+        '# fx zsh completion: place this file as _fx on your fpath.',
+        ...common,
+        '_fx() {',
+        '  local fx_current="${words[CURRENT]}" fx_candidates',
+        '  local -a fx_previous fx_matches',
+        '  if (( CURRENT > 2 )); then fx_previous=("${words[@]:1:$((CURRENT - 2))}"); fi',
+        '  _fx_candidates "${fx_previous[@]}"',
+        '  fx_matches=( ${(z)fx_candidates} )',
+        '  if (( ${#fx_matches} )); then compadd -- "${fx_matches[@]}"; fi',
+        '}',
+        '_fx "$@"',
+        '',
+    ].join('\n');
+}
+function powershell(entries) {
+    const q = (value) => `'${value.replaceAll("'", "''")}'`;
+    const array = (values) => `@(${values.map(q).join(', ')})`;
+    const metadata = entries.map((entry) => `${q(entry.id)} = @{ children = ${array(entry.children)}; routes = ${array(entry.routes)}; flags = ${array(entry.flags.map((flag) => flag.name))}; values = @{ ${entry.flags
+        .filter((flag) => flag.takesValue)
+        .map((flag) => `${q(flag.name)} = ${array(flag.options)}`)
+        .join('; ')} } }`);
+    return `# fx PowerShell completion: dot-source this file from your profile.
+$fxCommands = @{ ${metadata.join('; ')} }
+$fxCompleter = {
+  param($wordToComplete, $commandAst, $cursorPosition)
+  $words = @($commandAst.CommandElements | Select-Object -Skip 1 | Where-Object { $_.Extent.EndOffset -lt $cursorPosition } | ForEach-Object { if ($null -ne $_.Value) { $_.Value } else { $_.Extent.Text } })
+  $id = ''; $pending = ''
+  foreach ($word in $words) {
+    if ($pending) { $pending = ''; continue }
+    if ($word -eq '--') { return }
+    if ($fxCommands[$id].values.ContainsKey($word)) { $pending = $word; continue }
+    if ($word.StartsWith('-')) { continue }
+    if ($fxCommands[$id].routes -contains $word) { $id = ($id + ' ' + $word).Trim() }
+  }
+  if ($pending) { $candidates = $fxCommands[$id].values[$pending] }
+  elseif ($wordToComplete.StartsWith('-')) { $candidates = $fxCommands[$id].flags }
+  else { $candidates = $fxCommands[$id].children }
+  foreach ($candidate in $candidates) {
+    if ($candidate.StartsWith($wordToComplete, [StringComparison]::OrdinalIgnoreCase)) {
+      [System.Management.Automation.CompletionResult]::new($candidate, $candidate, 'ParameterValue', $candidate)
+    }
+  }
+}.GetNewClosure()
+$fxCompletionParams = @{ CommandName = @('fx', 'fx.cmd'); ScriptBlock = $fxCompleter }
+if ((Get-Command Register-ArgumentCompleter).Parameters.ContainsKey('Native')) { $fxCompletionParams.Native = $true }
+Register-ArgumentCompleter @fxCompletionParams
+`;
+}
+function fishCases(entries) {
+    const q = (value) => `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`;
+    const transitions = entries.flatMap((entry) => entry.routes.map((child) => `      case ${q(`${entry.id}:${child}`)}\n        set fx_cmd ${q([entry.id, child].filter(Boolean).join(' '))}`));
+    const options = entries.flatMap((entry) => entry.flags
+        .filter((flag) => flag.takesValue)
+        .map((flag) => `      case ${q(`${entry.id}:${flag.name}`)}\n        set fx_pending ${q(flag.name)}`));
+    const values = entries.flatMap((entry) => entry.flags
+        .filter((flag) => flag.options.length)
+        .map((flag) => `      case ${q(`${entry.id}:${flag.name}`)}\n        printf '%s\\n' ${flag.options.map(q).join(' ')}`));
+    const flags = entries.map((entry) => `      case ${q(entry.id)}\n        printf '%s\\n' ${entry.flags.map((flag) => q(flag.name)).join(' ')}`);
+    const children = entries
+        .filter((entry) => entry.children.length)
+        .map((entry) => `      case ${q(entry.id)}\n        printf '%s\\n' ${entry.children.map(q).join(' ')}`);
+    return { transitions, options, values, flags, children };
+}
+function fish(entries) {
+    const { transitions, options, values, flags, children } = fishCases(entries);
+    return [
+        '# fx fish completion: place this file in completions/fx.fish.',
+        'function _fx_complete',
+        '  set -l fx_words (commandline -opc)',
+        '  set -l fx_cmd ""',
+        '  set -l fx_pending ""',
+        '  for fx_token in $fx_words[2..-1]',
+        '    if test -n "$fx_pending"; set fx_pending ""; continue; end',
+        '    if test "$fx_token" = --; return; end',
+        '    switch "$fx_cmd:$fx_token"',
+        ...options,
+        '    end',
+        '    if string match -q -- "-*" "$fx_token"; continue; end',
+        '    switch "$fx_cmd:$fx_token"',
+        ...transitions,
+        '    end',
+        '  end',
+        '  if test -n "$fx_pending"',
+        '    switch "$fx_cmd:$fx_pending"',
+        ...values,
+        '    end',
+        '  else if string match -q -- "-*" (commandline -ct)',
+        '    switch "$fx_cmd"',
+        ...flags,
+        '    end',
+        '  else',
+        '    switch "$fx_cmd"',
+        ...children,
+        '    end',
+        '  end',
+        'end',
+        "complete -c fx -f -a '(_fx_complete)'",
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=completion.js.map

package/dist/cli/completion.js.map

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

package/dist/cli/config-flags.js

@@ -0,0 +1,18 @@
+// Map parsed CLI flags to settings through the key catalog; get and list must
+// report the same effective invocation values as command execution.
+import { KEYS } from '../application/config/keys.js';
+export function configFlagValues({ flags, argv, }) {
+    const values = {};
+    const terminator = argv.indexOf('--');
+    const tokens = terminator === -1 ? argv : argv.slice(0, terminator);
+    for (const key of KEYS) {
+        if (!key.flag ||
+            !tokens.some((token) => token === `--${key.flag}` || token.startsWith(`--${key.flag}=`)))
+            continue;
+        const value = key.flag === undefined ? undefined : flags[key.flag];
+        if (typeof value === 'string')
+            values[key.name] = value;
+    }
+    return values;
+}
+//# sourceMappingURL=config-flags.js.map

package/dist/cli/config-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-flags.js","sourceRoot":"","sources":["../../src/cli/config-flags.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AAEpE,OAAO,EAAE,IAAI,EAAgB,MAAM,+BAA+B,CAAC;AAOnE,MAAM,UAAU,gBAAgB,CAAC,EAC/B,KAAK,EACL,IAAI,GACY;IAChB,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IACE,CAAC,GAAG,CAAC,IAAI;YACT,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;YAExF,SAAS;QACX,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/flags.js

@@ -0,0 +1,95 @@
+// The global flags every command accepts, and the one flag every write
+// command adds. Defined once so `--help`, the docs generator and the commands
+// cannot disagree about them.
+import { Args, Flags } from '@oclif/core';
+import { COMMAND_SHELLS } from '../domain/shell.js';
+import { FORMATS } from './render/index.js';
+export const globalFlags = {
+    'command-shell': Flags.string({
+        options: [...COMMAND_SHELLS],
+        env: 'FX_COMMAND_SHELL',
+        description: 'shell for generated commands (does not change execution)',
+        helpGroup: 'GLOBAL',
+    }),
+    format: Flags.string({
+        options: [...FORMATS],
+        env: 'FX_FORMAT',
+        description: 'output format',
+        helpGroup: 'GLOBAL',
+    }),
+    fields: Flags.string({
+        description: 'comma-separated dot paths to keep in the output, e.g. name,obs.svc',
+        helpGroup: 'GLOBAL',
+    }),
+    details: Flags.boolean({
+        default: false,
+        description: 'include all report details; fact queries already return their full result',
+        helpGroup: 'GLOBAL',
+    }),
+    workspace: Flags.string({
+        env: 'FX_WORKSPACE',
+        description: 'select a registered name or root directory; otherwise use cwd then default_workspace; global commands still cover this FX_HOME',
+        helpGroup: 'GLOBAL',
+    }),
+    'no-input': Flags.boolean({
+        default: false,
+        description: 'never prompt; fail with a structured error instead',
+        helpGroup: 'GLOBAL',
+    }),
+    yes: Flags.boolean({
+        default: false,
+        description: 'assume yes for confirmations',
+        helpGroup: 'GLOBAL',
+    }),
+    quiet: Flags.boolean({
+        default: false,
+        description: 'suppress notices on stderr; errors are still reported',
+        helpGroup: 'GLOBAL',
+    }),
+    verbose: Flags.boolean({
+        default: false,
+        description: 'diagnostic detail on stderr',
+        helpGroup: 'GLOBAL',
+    }),
+    'no-header': Flags.boolean({
+        default: false,
+        description: 'omit column headings from human list output',
+        helpGroup: 'GLOBAL',
+    }),
+    'allow-writes': Flags.boolean({
+        default: false,
+        description: 'override read-only posture (read_only / FX_READ_ONLY) for this invocation',
+        helpGroup: 'GLOBAL',
+    }),
+};
+export const dryRunFlag = Flags.boolean({
+    default: false,
+    description: 'print the plan instead of applying it',
+});
+export const jobsFlag = Flags.integer({
+    default: 4,
+    min: 1,
+    description: 'independent checks handled at the same time',
+});
+export function listFlag(description, options) {
+    return Flags.string({
+        multiple: true,
+        delimiter: ',',
+        description: `${description} (repeatable or comma-separated)`,
+        ...(options === undefined ? {} : { options: [...options] }),
+    });
+}
+// What every write use case is told: whether this invocation may have effects
+// at all, and whether it was asked for the plan rather than the effect.
+export function writeIntent(flags, posture) {
+    return { dryRun: flags['dry-run'], posture };
+}
+// A positional argument never reads stdin: piped input is a document for the
+// command, not a missing value for its argument.
+export function argument(description) {
+    return Args.string({ ignoreStdin: true, description });
+}
+export function requiredArgument(description) {
+    return Args.string({ ignoreStdin: true, required: true, description });
+}
+//# sourceMappingURL=flags.js.map

package/dist/cli/flags.js.map

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

package/dist/cli/help.js

@@ -0,0 +1,69 @@
+// oclif's help plus the AGENT USAGE block: the part of the contract an agent needs even
+// when it has loaded no Skill. oclif constructs this class from the config alone, with no
+// command and so no Renderer, so help writes through its own `log` and is the one stdout
+// channel outside that contract. Every block goes through oclif's `section`, so its
+// heading is emphasised exactly where oclif emphasises its own.
+import { Help } from '@oclif/core';
+import { COMMAND_ALIASES, compatibilityTarget, EVERYDAY } from './commands/index.js';
+const AGENT_USAGE = `--format json     machine-readable output; collections are {items, has_more, next?}
+--format ndjson   one JSON object per line, for streaming
+--fields a,b.c    keep only these dot paths in the output
+--details         full report; combine with --format json for machine-readable details
+--no-header       omit headings from human list output
+--no-input        never prompt; a needed answer becomes a structured error
+--dry-run         on write commands: print the plan, change nothing
+--allow-writes    override read-only posture (read_only / FX_READ_ONLY) once
+Errors are JSON on stderr as {error:{category,code,message,hint,next_steps,retryable}};
+the category maps to a fixed exit code (usage 2, config 3, auth 4, permission 5,
+not_found 6, conflict 11). A LOGIN_REQUIRED error carries a handoff for the user.
+Human format on a terminal adds colour and prints errors as text; pipes and JSON never do.
+init/sync/doctor return preparation.state for their scope: planned, ready or incomplete.
+Incomplete preparation exits 12; preparation.next selects Agent actions or human handoff.
+Use resume only after prerequisites change. Release keeps ok/complete.
+Summaries retain exceptions and recovery; omitted counts normal rows/evidence.
+self info returns initialization_guide for setup and bundled_skill for other workflows.
+Global agent selection and tool inventory/history cover FX_HOME; --workspace does not narrow them.
+Help, completion, skill show and manifest schema return their native text/artifact formats.
+Set FX_FORMAT=json to apply the format to a whole session.`;
+const INITIALIZATION = `fx init "<directory>" --from "<manifest>" --dry-run --format json
+fx init "<directory>" --from "<manifest>" --format json
+Init prepares local tools, selected repositories and Agent resources and verifies them.
+Add --yes when the exact automatic effects are already authorized. Personal login stays manual.
+Read preparation.next: complete finishes setup; handoff waits for the listed prerequisites.
+Completed setup is already verified. Resume after human input with the returned resume action.`;
+export default class FxHelp extends Help {
+    get sortedCommands() {
+        return super.sortedCommands.filter((command) => compatibilityTarget(command.id) === undefined);
+    }
+    async showCommandHelp(command) {
+        const target = compatibilityTarget(command.id);
+        if (target)
+            this.log(`${this.section('COMPATIBILITY', `Use fx ${target.replaceAll(':', ' ')} for this operation.`)}\n`);
+        await super.showCommandHelp(command);
+        this.log(this.section('AGENT USAGE', AGENT_USAGE));
+    }
+    async showTopicHelp(topic) {
+        await super.showTopicHelp(topic);
+        const aliases = Object.entries(COMMAND_ALIASES).filter(([alias]) => alias.startsWith(`${topic.name}:`));
+        if (aliases.length) {
+            const names = aliases.map(([alias, canonical]) => `${alias.replaceAll(':', ' ')} -> ${canonical.replaceAll(':', ' ')}`);
+            this.log(`${this.section('COMPATIBILITY', names.join('\n'))}\n`);
+        }
+        this.log(this.section('AGENT USAGE', AGENT_USAGE));
+    }
+    async showRootHelp() {
+        const byId = new Map(this.sortedCommands.map((c) => [c.id, c]));
+        const everyday = EVERYDAY.flatMap((id) => byId.get(id) ?? []);
+        this.log(this.formatRoot());
+        this.log('');
+        this.log(this.section('FIRST WORKSPACE', INITIALIZATION));
+        this.log('');
+        // The heading may be emphasised, so it is not at the start of the text.
+        this.log(this.formatCommands(everyday).replace('COMMANDS', 'EVERYDAY'));
+        this.log('');
+        this.log(this.formatTopics(this.sortedTopics.filter((t) => !t.name.includes(':'))));
+        this.log('');
+        this.log(this.section('AGENT USAGE', AGENT_USAGE));
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

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

package/dist/cli/hook-command.js

@@ -0,0 +1,36 @@
+// The three hook commands differ only in the action they ask for; what they
+// report about the workspace projection is one view.
+import { HARNESS_COLUMNS } from '../application/harness/types.js';
+import { manageHooks } from '../application/hook/session.js';
+import { hookSession } from '../composition/hooks.js';
+import { FxCommand } from './base.js';
+export class HookCommand extends FxCommand {
+    async reconcile(action, dryRun) {
+        const out = await manageHooks({
+            ...hookSession({
+                container: this.container,
+                resolve: this.resolveInput(),
+                env: process.env,
+                posture: this.posture,
+            }),
+            action,
+            dryRun,
+        });
+        this.renderer.list(out.items, {
+            columns: HARNESS_COLUMNS,
+            trailer: {
+                workspace: out.workspace,
+                root: out.root,
+                enabled: out.enabled,
+                observations: out.state?.observations ?? [],
+            },
+        });
+    }
+}
+export class HookProjectionCommand extends HookCommand {
+    async run() {
+        const { flags } = await this.parse();
+        await this.reconcile(this.action, flags['dry-run']);
+    }
+}
+//# sourceMappingURL=hook-command.js.map

package/dist/cli/hook-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-command.js","sourceRoot":"","sources":["../../src/cli/hook-command.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,qDAAqD;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAMtC,MAAM,OAAgB,WAAY,SAAQ,SAAS;IACvC,KAAK,CAAC,SAAS,CAAC,MAAgC,EAAE,MAAe;QACzE,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC;YAC5B,GAAG,WAAW,CAAC;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE;gBAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC;YACF,MAAM;YACN,MAAM;SACP,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE;YAC5B,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE;gBACP,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,YAAY,EAAE,GAAG,CAAC,KAAK,EAAE,YAAY,IAAI,EAAE;aAC5C;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAgB,qBAAsB,SAAQ,WAAW;IAG7D,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAkC,CAAC;QACrE,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,CAAC;CACF"}