@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/application/config/keys.js

@@ -0,0 +1,65 @@
+// The registry of personal settings. Everything that mentions a key — the
+// resolver, `config list`, "did you mean", help text — derives from this
+// table. The domain config codec owns the stored shape.
+import { DEFAULT_FORMAT, FORMATS } from '../../domain/format.js';
+import { COMMAND_SHELLS } from '../../domain/shell.js';
+export const KEYS = [
+    {
+        name: 'command_shell',
+        env: 'FX_COMMAND_SHELL',
+        flag: 'command-shell',
+        kind: 'enum',
+        default: 'auto',
+        options: COMMAND_SHELLS,
+        desc: 'shell used for generated commands; auto selects PowerShell on Windows and POSIX elsewhere',
+    },
+    {
+        name: 'hooks',
+        env: 'FX_HOOKS',
+        kind: 'bool',
+        default: 'true',
+        desc: 'allow workspace lifecycle hooks; each workspace can also disable them',
+    },
+    {
+        name: 'default_workspace',
+        env: 'FX_WORKSPACE',
+        flag: 'workspace',
+        kind: 'string',
+        desc: 'workspace used when the current directory is not inside one',
+    },
+    {
+        name: 'user',
+        env: 'FX_USER',
+        kind: 'string',
+        desc: 'code-host username, the namespace of your forks',
+    },
+    {
+        name: 'format',
+        env: 'FX_FORMAT',
+        flag: 'format',
+        kind: 'enum',
+        default: DEFAULT_FORMAT,
+        options: FORMATS,
+        desc: 'default output format',
+    },
+    {
+        name: 'agents',
+        env: 'FX_AGENTS',
+        kind: 'list',
+        desc: 'coding agents that receive Skills and lifecycle hooks; omit to auto-detect',
+    },
+    {
+        name: 'read_only',
+        env: 'FX_READ_ONLY',
+        kind: 'bool',
+        desc: 'refuse every write unless --allow-writes is passed',
+    },
+    {
+        name: 'update_check',
+        env: 'FX_UPDATE_CHECK',
+        kind: 'bool',
+        default: 'true',
+        desc: 'say on stderr when a newer fx is published or the manifest repository moved upstream',
+    },
+];
+//# sourceMappingURL=keys.js.map

package/dist/application/config/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/application/config/keys.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AACzE,wDAAwD;AAGxD,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAevD,MAAM,CAAC,MAAM,IAAI,GAAmB;IAClC;QACE,IAAI,EAAE,eAAe;QACrB,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,cAAc;QACvB,IAAI,EAAE,2FAA2F;KAClG;IACD;QACE,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,UAAU;QACf,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,uEAAuE;KAC9E;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,6DAA6D;KACpE;IACD;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,iDAAiD;KACxD;IACD;QACE,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,cAAc;QACvB,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,uBAAuB;KAC9B;IACD;QACE,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,4EAA4E;KACnF;IACD;QACE,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,oDAAoD;KAC3D;IACD;QACE,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,iBAAiB;QACtB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,sFAAsF;KAC7F;CACF,CAAC"}

package/dist/application/config/list.js

@@ -0,0 +1,30 @@
+// Every setting with its effective value, walked from the key registry so a new
+// key appears here without being added.
+import { KEYS } from './keys.js';
+import { resolveKey } from './resolve.js';
+export const CONFIG_COLUMNS = ['key', 'value', 'source', 'env', 'desc'];
+export class ListConfig {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async execute(input) {
+        const file = await this.store.read();
+        return KEYS.map((key) => {
+            const resolved = resolveKey(key.name, {
+                env: input.env,
+                file,
+                flag: input.flags?.[key.name],
+            });
+            return {
+                key: key.name,
+                value: resolved.value ?? null,
+                source: resolved.source,
+                env: key.env,
+                kind: key.kind,
+                desc: key.desc,
+            };
+        });
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/application/config/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/application/config/list.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wCAAwC;AAIxC,OAAO,EAAE,IAAI,EAA8B,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAgB5D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AAEjF,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,KAAkB;QAAlB,UAAK,GAAL,KAAK,CAAa;IAAG,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,KAAsB;QAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACtB,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;gBACpC,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,IAAI;gBACJ,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;aAC9B,CAAC,CAAC;YACH,OAAO;gBACL,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI;gBAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;aACf,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/application/config/resolve.js

@@ -0,0 +1,33 @@
+// Layered resolution of one setting: flag > env > file > default. Every layer is
+// reported, not just the winner, so `--explain` can show why a value is what it is.
+import { DevkitError } from '../../domain/errors.js';
+import { nearest } from '../../domain/fuzzy.js';
+import { KEYS } from './keys.js';
+import { spellValue, storedValue } from './values.js';
+export function findKey(name) {
+    const key = KEYS.find((k) => k.name === name);
+    if (key !== undefined)
+        return key;
+    const suggestion = nearest(name, KEYS.map((k) => k.name));
+    const hint = suggestion === undefined
+        ? `Known keys: ${KEYS.map((k) => k.name).join(', ')}.`
+        : `Did you mean "${suggestion}"?`;
+    throw new DevkitError('usage', 'CONFIG_KEY_UNKNOWN', `Unknown config key "${name}"`, {
+        hint,
+        nextSteps: ['fx config list'],
+    });
+}
+export function resolveKey(name, input) {
+    const key = findKey(name);
+    const layers = [
+        ...(key.flag === undefined
+            ? []
+            : [{ source: 'flag', value: input.flag, origin: `--${key.flag}` }]),
+        { source: 'env', value: input.env[key.env], origin: key.env },
+        { source: 'file', value: spellValue(storedValue(input.file, key)), origin: 'config.yaml' },
+        { source: 'default', value: key.default, origin: 'built-in' },
+    ];
+    const active = layers.find((l) => l.value !== undefined) ?? layers[layers.length - 1];
+    return { key, value: active?.value, source: active?.source ?? 'default', layers };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/application/config/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/application/config/resolve.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oFAAoF;AAEpF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,OAAO,EAAE,IAAI,EAAY,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAuBtD,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClC,MAAM,UAAU,GAAG,OAAO,CACxB,IAAI,EACJ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACxB,CAAC;IACF,MAAM,IAAI,GACR,UAAU,KAAK,SAAS;QACtB,CAAC,CAAC,eAAe,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACtD,CAAC,CAAC,iBAAiB,UAAU,IAAI,CAAC;IACtC,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,IAAI,GAAG,EAAE;QACnF,IAAI;QACJ,SAAS,EAAE,CAAC,gBAAgB,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAmB;IAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,MAAM,GAAY;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS;YACxB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAe,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9E,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE;QAC7D,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE;QAC1F,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE;KAC9D,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtF,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,EAAE,CAAC;AACpF,CAAC"}

package/dist/application/config/set.js

@@ -0,0 +1,36 @@
+// Plan and apply a validated personal setting.
+import { assertWritable } from '../safety/posture.js';
+import { assertDefaultWorkspace } from '../workspace/registry.js';
+import { findKey } from './resolve.js';
+import { parseValue, spellValue, storedValue } from './values.js';
+export class SetConfig {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async execute(input) {
+        const key = findKey(input.key);
+        const value = parseValue(key, input.value);
+        const file = await this.store.read();
+        if (key.name === 'default_workspace')
+            assertDefaultWorkspace({ ...file, default_workspace: String(value) });
+        const plan = {
+            path: this.store.path(),
+            key: key.name,
+            before: spellValue(storedValue(file, key)) ?? null,
+            after: spellValue(value) ?? '',
+            written: false,
+        };
+        if (input.dryRun)
+            return plan;
+        assertWritable(input.posture, `config set ${key.name}`);
+        await this.store.update((current) => {
+            const next = { ...current, [key.name]: value };
+            if (key.name === 'default_workspace')
+                assertDefaultWorkspace(next);
+            return next;
+        });
+        return { ...plan, written: true };
+    }
+}
+//# sourceMappingURL=set.js.map

package/dist/application/config/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/application/config/set.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAG/C,OAAO,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiBlE,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,KAAkB;QAAlB,UAAK,GAAL,KAAK,CAAa;IAAG,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,KAAqB;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB;YAClC,sBAAsB,CAAC,EAAE,GAAG,IAAI,EAAE,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,GAAoB;YAC5B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YACvB,GAAG,EAAE,GAAG,CAAC,IAAI;YACb,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI;YAClD,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE;YAC9B,OAAO,EAAE,KAAK;SACf,CAAC;QACF,IAAI,KAAK,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC9B,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB;gBAAE,sBAAsB,CAAC,IAAI,CAAC,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/application/config/settings.js

@@ -0,0 +1,38 @@
+// Every personal setting of one invocation, already typed. Coercion follows the
+// kind each key declares in the catalog, so a default such as "hooks are on
+// unless the value spells false" is written once rather than at every reader.
+import { parseBoolean, parseList } from '../../domain/values.js';
+import { KEYS } from './keys.js';
+import { resolveKey } from './resolve.js';
+export function readSettings(input) {
+    const values = new Map(KEYS.map((key) => [key.name, valueOf(key, input)]));
+    // The kind table decides each shape; the accessors only name the expectation.
+    const text = (name) => values.get(name);
+    const flag = (name) => values.get(name);
+    const list = (name) => values.get(name);
+    return {
+        commandShell: text('command_shell'),
+        defaultWorkspace: text('default_workspace'),
+        user: text('user'),
+        format: text('format'),
+        agents: list('agents'),
+        hooks: flag('hooks'),
+        readOnly: flag('read_only'),
+        updateCheck: flag('update_check'),
+    };
+}
+function valueOf(key, input) {
+    const flag = input.flags?.[key.name];
+    const resolved = resolveKey(key.name, { flag, env: input.env, file: input.file }).value;
+    switch (key.kind) {
+        case 'bool':
+            // An unreadable spelling keeps the built-in answer rather than inverting it.
+            return parseBoolean(resolved) ?? parseBoolean(key.default) ?? false;
+        case 'list':
+            return parseList(resolved);
+        case 'string':
+        case 'enum':
+            return resolved;
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/application/config/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../src/application/config/settings.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4EAA4E;AAC5E,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,EAAE,IAAI,EAA0B,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmB1C,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,8EAA8E;IAC9E,MAAM,IAAI,GAAG,CAAC,IAAa,EAAsB,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAuB,CAAC;IAC3F,MAAM,IAAI,GAAG,CAAC,IAAa,EAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAY,CAAC;IACrE,MAAM,IAAI,GAAG,CAAC,IAAa,EAAiC,EAAE,CAC5D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAkC,CAAC;IACpD,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC;QACnC,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC;QAC3C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;QACtB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;QACtB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;QAC3B,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAAQ,EAAE,KAAoB;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;IACxF,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,6EAA6E;YAC7E,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;QACtE,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC7B,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/application/config/unset.js

@@ -0,0 +1,31 @@
+// Removing one setting. A key that was not set is not an error: the plan simply
+// reports that nothing was written.
+import { assertWritable } from '../safety/posture.js';
+import { findKey } from './resolve.js';
+import { spellValue, storedValue } from './values.js';
+export class UnsetConfig {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async execute(input) {
+        const key = findKey(input.key);
+        const file = await this.store.read();
+        const before = spellValue(storedValue(file, key)) ?? null;
+        const plan = {
+            path: this.store.path(),
+            key: key.name,
+            before,
+            written: false,
+        };
+        if (input.dryRun || before === null)
+            return plan;
+        assertWritable(input.posture, `config unset ${key.name}`);
+        await this.store.update((current) => {
+            const { [key.name]: _removed, ...rest } = current;
+            return rest;
+        });
+        return { ...plan, written: true };
+    }
+}
+//# sourceMappingURL=unset.js.map

package/dist/application/config/unset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unset.js","sourceRoot":"","sources":["../../../src/application/config/unset.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,oCAAoC;AAGpC,OAAO,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAetD,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,KAAkB;QAAlB,UAAK,GAAL,KAAK,CAAa;IAAG,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,KAAuB;QACnC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;QAC1D,MAAM,IAAI,GAAsB;YAC9B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YACvB,GAAG,EAAE,GAAG,CAAC,IAAI;YACb,MAAM;YACN,OAAO,EAAE,KAAK;SACf,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACjD,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/application/config/values.js

@@ -0,0 +1,36 @@
+// Conversion between a key's stored shape and the single string a person
+// types or reads. Both directions live together so they cannot drift.
+import { DevkitError } from '../../domain/errors.js';
+import { parseBoolean, parseList } from '../../domain/values.js';
+export function parseValue(key, text) {
+    switch (key.kind) {
+        case 'string':
+            return text;
+        case 'enum':
+            if (key.options?.includes(text))
+                return text;
+            throw invalid(key, text, `one of ${key.options?.join(', ')}`);
+        case 'list':
+            return parseList(text) ?? [];
+        case 'bool': {
+            const parsed = parseBoolean(text);
+            if (parsed !== undefined)
+                return parsed;
+            throw invalid(key, text, 'true or false');
+        }
+    }
+}
+export function spellValue(value) {
+    if (value === undefined)
+        return undefined;
+    if (Array.isArray(value))
+        return value.join(',');
+    return String(value);
+}
+export function storedValue(file, key) {
+    return file[key.name];
+}
+function invalid(key, text, expected) {
+    return new DevkitError('usage', 'CONFIG_VALUE_INVALID', `"${text}" is not a valid value for ${key.name}: expected ${expected}`, { hint: key.desc, nextSteps: ['fx config list'] });
+}
+//# sourceMappingURL=values.js.map

package/dist/application/config/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/application/config/values.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,sEAAsE;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAOjE,MAAM,UAAU,UAAU,CAAC,GAAQ,EAAE,IAAY;IAC/C,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC;QACd,KAAK,MAAM;YACT,IAAI,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7C,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC;YACxC,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAA8B;IACvD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,GAAQ;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,OAAO,CAAC,GAAQ,EAAE,IAAY,EAAE,QAAgB;IACvD,OAAO,IAAI,WAAW,CACpB,OAAO,EACP,sBAAsB,EACtB,IAAI,IAAI,8BAA8B,GAAG,CAAC,IAAI,cAAc,QAAQ,EAAE,EACtE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAClD,CAAC;AACJ,CAAC"}

package/dist/application/contribution/apply-source.js

@@ -0,0 +1,133 @@
+// Journal transitions precede publication and PR creation. A lost push response
+// is recoverable by commit identity; a lost PR response needs explicit association.
+import { DevkitError } from '../../domain/errors.js';
+import { assertMatchingPr, divergedError } from './plan-existing.js';
+export async function applySource({ deps, input, plan, }) {
+    let records = plan.records.filter((record) => !plan.output.retired.includes(record.id));
+    const save = async (record) => {
+        const next = { ...record, updatedAt: deps.clock.now().toISOString() };
+        const exists = records.some((item) => item.id === next.id);
+        records = exists
+            ? records.map((item) => (item.id === next.id ? next : item))
+            : [...records, next];
+        await deps.records.write(deps.source.workspace, records);
+    };
+    if (plan.output.action === 'unchanged') {
+        if (plan.output.retired.length)
+            await deps.records.write(deps.source.workspace, records);
+        return { ...plan.output, written: plan.output.retired.length > 0 };
+    }
+    if (plan.output.action === 'associate') {
+        const pr = plan.output.pull_request;
+        if (pr.state === 'open')
+            await save({ ...plan.operation, phase: 'open', pullRequestId: pr.id, pullRequest: pr.url });
+        else
+            await deps.records.write(deps.source.workspace, records.filter((item) => item.id !== plan.operation.id));
+        return { ...plan.output, written: true };
+    }
+    let operation = plan.operation;
+    if (!operation || operation.phase === 'open') {
+        operation = prepareOperation(deps, plan);
+        await save(operation);
+    }
+    operation = await publishOperation({ deps, input, plan, operation, save });
+    return completePullRequest({ deps, input, plan, operation, save });
+}
+async function publishOperation(context) {
+    const { deps, plan, save } = context;
+    let { operation } = context;
+    if (operation.phase === 'prepared') {
+        const prepared = await deps.git.prepare({
+            snapshot: plan.snapshot,
+            branch: operation.branch,
+            parent: operation.parent,
+            expectedHead: operation.previousHead,
+            message: plan.output.message,
+        });
+        if (prepared.tree !== operation.tree)
+            throw new DevkitError('conflict', 'SOURCE_TREE_MISMATCH', 'The prepared tree differs from the validated plan', {
+                nextSteps: ['Re-run the same fx source push command with --dry-run and review the plan.'],
+            });
+        operation = { ...operation, commit: prepared.commit, phase: 'committed' };
+        await save(operation);
+    }
+    if (operation.phase === 'committed') {
+        await deps.git.publish({
+            ...deps.source,
+            branch: operation.branch,
+            commit: operation.commit,
+            expectedHead: operation.previousHead,
+        });
+        const request = {
+            ...deps.source,
+            remote: plan.remote,
+            branch: operation.branch,
+            commit: operation.commit,
+        };
+        const head = await deps.transport.head(request);
+        if (head !== operation.commit && head !== operation.previousHead)
+            throw divergedError();
+        if (head !== operation.commit)
+            await deps.transport.push(request);
+        operation = { ...operation, phase: 'pushed' };
+        await save(operation);
+    }
+    return operation;
+}
+function prepareOperation(deps, plan) {
+    const snapshot = plan.snapshot;
+    const previous = plan.operation;
+    return {
+        id: previous?.id ?? plan.allocatedId,
+        remoteIdentity: plan.identity,
+        branch: plan.output.branch,
+        baseBranch: plan.remote.targetBranch,
+        base: snapshot.base,
+        parent: previous?.commit ?? snapshot.base,
+        previousHead: previous?.commit ?? null,
+        sourceFingerprint: snapshot.fingerprint,
+        paths: snapshot.paths,
+        files: snapshot.files.map((file) => file.path),
+        tree: snapshot.tree,
+        commit: null,
+        phase: 'prepared',
+        pullRequestId: previous?.pullRequestId ?? null,
+        pullRequest: previous?.pullRequest ?? null,
+        updatedAt: deps.clock.now().toISOString(),
+    };
+}
+async function completePullRequest(context) {
+    const { input, plan, operation, save } = context;
+    if (operation.phase !== 'pushed')
+        throw new DevkitError('conflict', 'SOURCE_PR_CONFIRM_REQUIRED', 'Confirm the existing PR with --pr before resuming', {
+            nextSteps: [
+                `Find the pull request for branch ${operation.branch} on the code host.`,
+                'Re-run the same fx source push command with --pr <pr-id>.',
+            ],
+        });
+    let pr;
+    if (operation.pullRequestId) {
+        pr = await plan.host.pullRequest({ repo: plan.remote.target, id: operation.pullRequestId });
+        if (!pr || pr.state !== 'open')
+            throw new DevkitError('conflict', 'SOURCE_PR_CLOSED', 'The PR closed during contribution; review before using --new', {
+                nextSteps: [
+                    `Review pull request ${operation.pullRequestId} on the code host.`,
+                    'Start a separate contribution with fx source push --new.',
+                ],
+            });
+        assertMatchingPr(pr, operation, plan);
+    }
+    else {
+        await save({ ...operation, phase: 'creating_pr' });
+        pr = await plan.host.createPullRequest({
+            source: { repo: plan.remote.source, branch: operation.branch },
+            target: { repo: plan.remote.target, branch: operation.baseBranch },
+            title: input.title,
+            description: `Issue: ${input.issue}\n\nFiles:\n${operation.files.map((file) => `- ${file}`).join('\n')}\n`,
+            allowWrites: input.posture.source === 'flag' && !input.posture.readOnly,
+        });
+    }
+    await save({ ...operation, phase: 'open', pullRequestId: pr.id, pullRequest: pr.url });
+    return { ...plan.output, commit: operation.commit, pull_request: pr, written: true };
+}
+//# sourceMappingURL=apply-source.js.map

package/dist/application/contribution/apply-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-source.js","sourceRoot":"","sources":["../../../src/application/contribution/apply-source.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,oFAAoF;AAGpF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAcrE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAChC,IAAI,EACJ,KAAK,EACL,IAAI,GACc;IAClB,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,KAAK,EAAE,MAA6B,EAAiB,EAAE;QAClE,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACtE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,OAAO,GAAG,MAAM;YACd,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzF,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,YAAa,CAAC;QACrC,IAAI,EAAE,CAAC,KAAK,KAAK,MAAM;YACrB,MAAM,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,SAAU,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;;YAE7F,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CACtB,IAAI,CAAC,MAAM,CAAC,SAAS,EACrB,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,SAAU,CAAC,EAAE,CAAC,CACzD,CAAC;QACJ,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/B,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC7C,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IACD,SAAS,GAAG,MAAM,gBAAgB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,OAAO,mBAAmB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACrE,CAAC;AAOD,KAAK,UAAU,gBAAgB,CAAC,OAA4B;IAC1D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACrC,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC5B,IAAI,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YACtC,QAAQ,EAAE,IAAI,CAAC,QAAS;YACxB,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAQ;SAC9B,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;YAClC,MAAM,IAAI,WAAW,CACnB,UAAU,EACV,sBAAsB,EACtB,mDAAmD,EACnD;gBACE,SAAS,EAAE,CAAC,4EAA4E,CAAC;aAC1F,CACF,CAAC;QACJ,SAAS,GAAG,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAC1E,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QACpC,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YACrB,GAAG,IAAI,CAAC,MAAM;YACd,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,MAAM,EAAE,SAAS,CAAC,MAAO;YACzB,YAAY,EAAE,SAAS,CAAC,YAAY;SACrC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG;YACd,GAAG,IAAI,CAAC,MAAM;YACd,MAAM,EAAE,IAAI,CAAC,MAAO;YACpB,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,MAAM,EAAE,SAAS,CAAC,MAAO;SAC1B,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,IAAI,KAAK,SAAS,CAAC,MAAM,IAAI,IAAI,KAAK,SAAS,CAAC,YAAY;YAAE,MAAM,aAAa,EAAE,CAAC;QACxF,IAAI,IAAI,KAAK,SAAS,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClE,SAAS,GAAG,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAoB,EAAE,IAAgB;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAS,CAAC;IAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;IAChC,OAAO;QACL,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,IAAI,CAAC,WAAW;QACpC,cAAc,EAAE,IAAI,CAAC,QAAQ;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QAC1B,UAAU,EAAE,IAAI,CAAC,MAAO,CAAC,YAAY;QACrC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,QAAQ,CAAC,IAAI;QACzC,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,IAAI;QACtC,iBAAiB,EAAE,QAAQ,CAAC,WAAW;QACvC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9C,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,UAAU;QACjB,aAAa,EAAE,QAAQ,EAAE,aAAa,IAAI,IAAI;QAC9C,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,IAAI;QAC1C,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAC1C,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,OAA4B;IAC7D,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACjD,IAAI,SAAS,CAAC,KAAK,KAAK,QAAQ;QAC9B,MAAM,IAAI,WAAW,CACnB,UAAU,EACV,4BAA4B,EAC5B,mDAAmD,EACnD;YACE,SAAS,EAAE;gBACT,oCAAoC,SAAS,CAAC,MAAM,oBAAoB;gBACxE,2DAA2D;aAC5D;SACF,CACF,CAAC;IACJ,IAAI,EAAE,CAAC;IACP,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;QAC5B,EAAE,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAO,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,KAAK,MAAM;YAC5B,MAAM,IAAI,WAAW,CACnB,UAAU,EACV,kBAAkB,EAClB,8DAA8D,EAC9D;gBACE,SAAS,EAAE;oBACT,uBAAuB,SAAS,CAAC,aAAa,oBAAoB;oBAClE,0DAA0D;iBAC3D;aACF,CACF,CAAC;QACJ,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,CAAC,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QACnD,EAAE,GAAG,MAAM,IAAI,CAAC,IAAK,CAAC,iBAAiB,CAAC;YACtC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE;YAC/D,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,UAAU,EAAE;YACnE,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,UAAU,KAAK,CAAC,KAAK,eAAe,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC1G,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ;SACxE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,CAAC,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IACvF,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvF,CAAC"}

package/dist/application/contribution/collect-input.js

@@ -0,0 +1,39 @@
+// Missing contribution inputs are questions, never an implicit all-files
+// selection. A prompter without a person returns INPUT_REQUIRED.
+import { DevkitError } from '../../domain/errors.js';
+export class CollectContributionInput {
+    prompter;
+    constructor(prompter) {
+        this.prompter = prompter;
+    }
+    async execute(input) {
+        const paths = input.paths.length
+            ? input.paths
+            : parseSelection(await this.prompter.ask('Source-relative paths (comma-separated or a JSON string array):'));
+        const issue = input.issue ?? (await this.prompter.ask('Issue ID for the contribution commit:'));
+        const title = input.title ?? (await this.prompter.ask('Pull request title:'));
+        return { ...input, paths: [...new Set(paths)], issue: issue.trim(), title: title.trim() };
+    }
+}
+function parseSelection(text) {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith('['))
+        return trimmed
+            .split(',')
+            .map((value) => value.trim())
+            .filter(Boolean);
+    try {
+        const value = JSON.parse(trimmed);
+        if (Array.isArray(value) && value.every((item) => typeof item === 'string' && item.trim()))
+            return value;
+    }
+    catch {
+        /* Malformed selection never falls back to all changed files. */
+    }
+    throw new DevkitError('usage', 'SOURCE_SELECTION_INVALID', 'Enter source paths as a comma-separated list or JSON string array', {
+        nextSteps: [
+            'Enter manifest/workspace.yaml,manifest/environments.yaml or ["manifest/workspace.yaml"].',
+        ],
+    });
+}
+//# sourceMappingURL=collect-input.js.map

package/dist/application/contribution/collect-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-input.js","sourceRoot":"","sources":["../../../src/application/contribution/collect-input.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,iEAAiE;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAUrD,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAEnD,KAAK,CAAC,OAAO,CAAC,KAAgC;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM;YAC9B,CAAC,CAAC,KAAK,CAAC,KAAK;YACb,CAAC,CAAC,cAAc,CACZ,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CACrB,iEAAiE,CAClE,CACF,CAAC;QACN,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC,CAAC;QAChG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC9E,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;IAC5F,CAAC;CACF;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAC1B,OAAO,OAAO;aACX,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;aAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACxF,OAAO,KAAK,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;IACD,MAAM,IAAI,WAAW,CACnB,OAAO,EACP,0BAA0B,EAC1B,mEAAmE,EACnE;QACE,SAAS,EAAE;YACT,0FAA0F;SAC3F;KACF,CACF,CAAC;AACJ,CAAC"}

package/dist/application/contribution/identity.js

@@ -0,0 +1,23 @@
+// Recheck the captured registration under the operation lease before writing source state.
+import { DevkitError } from '../../domain/errors.js';
+import { samePath } from '../../domain/path.js';
+import { shellLine } from '../../domain/shell.js';
+import { assertNoWorkspaceOperation } from '../workspace/health.js';
+export async function assertContributionIdentity(deps) {
+    const { config, fs, expected, physicalRoot, logicalSourceDir } = deps.registration;
+    const current = (await config.read()).workspaces?.[deps.source.workspace];
+    if (!current ||
+        current.root !== expected.root ||
+        current.source !== expected.source ||
+        !samePath(await fs.realpath(current.root), physicalRoot) ||
+        (await fs.readLink(logicalSourceDir)) !== undefined ||
+        !samePath(await fs.realpath(logicalSourceDir), deps.source.dir) ||
+        (await fs.readLink(deps.source.dir)) !== undefined ||
+        !samePath(await fs.realpath(deps.source.dir), deps.source.dir))
+        throw new DevkitError('conflict', 'WORKSPACE_PLAN_CHANGED', 'The registered source identity changed after contribution planning', {
+            hint: 'Inspect the current workspace and preview the contribution again before retrying.',
+            nextSteps: [shellLine(['fx', 'workspace', 'show', deps.source.workspace])],
+        });
+    await assertNoWorkspaceOperation({ fs }, { name: deps.source.workspace, manifestDir: logicalSourceDir });
+}
+//# sourceMappingURL=identity.js.map

package/dist/application/contribution/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/application/contribution/identity.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAIpE,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAqD;IAErD,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;IACnF,MAAM,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1E,IACE,CAAC,OAAO;QACR,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;QAC9B,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QAClC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;QACxD,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,KAAK,SAAS;QACnD,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QAC/D,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS;QAClD,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;QAE9D,MAAM,IAAI,WAAW,CACnB,UAAU,EACV,wBAAwB,EACxB,oEAAoE,EACpE;YACE,IAAI,EAAE,mFAAmF;YACzF,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;SAC3E,CACF,CAAC;IACJ,MAAM,0BAA0B,CAC9B,EAAE,EAAE,EAAE,EACN,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAC/D,CAAC;AACJ,CAAC"}