@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/infra/tool-history.js

@@ -0,0 +1,94 @@
+// A versioned personal ledger preserves every checkpoint under an atomic, locked append.
+// Invalid or foreign files fail closed, so installation cannot silently lose its audit trail.
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import * as z from 'zod';
+import { busyError, DevkitError } from '../domain/errors.js';
+import { writeAtomicFile } from './atomic-file.js';
+const entry = {
+    id: z.string().uuid(),
+    at: z.string().datetime(),
+    event: z.enum(['started', 'installed', 'finished']),
+    operation: z.enum(['init', 'install', 'update']),
+    workspace: z.string().nullable(),
+    name: z.string(),
+    binary: z.string(),
+    via: z.enum(['npm', 'brew', 'go']),
+    spec: z.string(),
+    vector: z.array(z.string()),
+    code: z.number().int().nullable(),
+    version_after: z.string().nullable(),
+    binary_path: z.string().nullable(),
+    failure_code: z.string().nullable(),
+    installation_origin: z.enum(['fx', 'external', 'unknown']).optional(),
+    binary_path_before: z.string().nullable().optional(),
+};
+const ledger = (object) => object({
+    owner: z.enum(['fx:tool-history:v1', 'fx:tool-history:v2']),
+    entries: z.array(object(entry)),
+});
+const written = ledger(z.strictObject);
+const read = ledger(z.object);
+export class FileToolHistoryStore {
+    home;
+    lock;
+    constructor(home, lock) {
+        this.home = home;
+        this.lock = lock;
+    }
+    async read() {
+        await this.checkHome();
+        try {
+            const stat = await fs.lstat(this.file());
+            if (!stat.isFile() || stat.nlink !== 1)
+                throw invalid();
+            return read.parse(JSON.parse(await fs.readFile(this.file(), 'utf8'))).entries;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw invalid();
+        }
+    }
+    async append(entry) {
+        await this.checkHome();
+        const lease = await this.lock.acquire({ key: 'tool-history', waitMs: 2000 });
+        if (!lease)
+            throw busyError('TOOL_HISTORY_BUSY', 'The tool history', {
+                nextSteps: ['Retry after the other tool operation finishes.'],
+            });
+        try {
+            const entries = [...(await this.read()), entry];
+            const parsed = written.safeParse({ owner: 'fx:tool-history:v2', entries });
+            if (!parsed.success)
+                throw invalid();
+            await fs.mkdir(this.home, { recursive: true, mode: 0o700 });
+            await this.checkHome();
+            await writeAtomicFile(this.file(), JSON.stringify(parsed.data) + '\n', { durable: true });
+        }
+        finally {
+            await lease.release();
+        }
+    }
+    file() {
+        return path.join(this.home, 'tool-history.json');
+    }
+    async checkHome() {
+        try {
+            if (!(await fs.lstat(this.home)).isDirectory())
+                throw invalid();
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw invalid();
+        }
+    }
+}
+function invalid() {
+    return new DevkitError('config', 'TOOL_HISTORY_INVALID', 'The tool installation ledger is invalid or unreadable', {
+        nextSteps: [
+            'Inspect and repair FX_HOME/tool-history.json, preserving the existing audit evidence, before retrying.',
+        ],
+    });
+}
+//# sourceMappingURL=tool-history.js.map

package/dist/infra/tool-history.js.map

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

package/dist/infra/trace-file.js

@@ -0,0 +1,7 @@
+// Appends a line to the trace file. Missing directories are not created:
+// the file is the caller's to place.
+import { promises as fs } from 'node:fs';
+export function appendLineTo(file) {
+    return (line) => fs.appendFile(file, line, 'utf8');
+}
+//# sourceMappingURL=trace-file.js.map

package/dist/infra/trace-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-file.js","sourceRoot":"","sources":["../../src/infra/trace-file.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,qCAAqC;AAErC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC"}

package/dist/infra/trust-store.js

@@ -0,0 +1,67 @@
+// Persist approved command fingerprints under a file lease; command vectors stay
+// in the manifest. Queue approvals within one command to avoid self-contention.
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { parse, stringify } from 'yaml';
+import { busyError } from '../domain/errors.js';
+import { writeAtomicFile } from './atomic-file.js';
+export class FileTrustStore {
+    home;
+    clock;
+    lock;
+    pending = Promise.resolve();
+    constructor(home, clock, lock) {
+        this.home = home;
+        this.clock = clock;
+        this.lock = lock;
+    }
+    path() {
+        return path.join(this.home, 'trust.yaml');
+    }
+    async isTrusted(workspace, fingerprint) {
+        return (await this.read()).workspaces?.[workspace]?.[fingerprint] !== undefined;
+    }
+    trust(workspace, fingerprint, label) {
+        const operation = this.pending.then(() => this.record(workspace, fingerprint, label));
+        this.pending = operation.catch(() => undefined);
+        return operation;
+    }
+    async record(workspace, fingerprint, label) {
+        const lease = await this.lock.acquire({ key: this.path(), waitMs: 2000 });
+        if (lease === null)
+            throw busyError('LOCK_BUSY', 'The trust record');
+        try {
+            await this.writeRecord(workspace, fingerprint, label);
+        }
+        finally {
+            await lease.release();
+        }
+    }
+    async writeRecord(workspace, fingerprint, label) {
+        const file = await this.read();
+        const entries = {
+            ...file.workspaces?.[workspace],
+            [fingerprint]: { label, trusted_at: this.clock.now().toISOString() },
+        };
+        await fs.mkdir(this.home, { recursive: true });
+        await writeAtomicFile(this.path(), stringify({ workspaces: { ...file.workspaces, [workspace]: entries } }));
+    }
+    async list(workspace) {
+        return Object.entries((await this.read()).workspaces?.[workspace] ?? {}).map(([fingerprint, e]) => ({
+            fingerprint,
+            label: e.label,
+            trusted_at: e.trusted_at,
+        }));
+    }
+    async read() {
+        try {
+            return parse(await fs.readFile(this.path(), 'utf8')) ?? {};
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return {};
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=trust-store.js.map

package/dist/infra/trust-store.js.map

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

package/dist/infra/workspace-home.js

@@ -0,0 +1,15 @@
+// ~/.fx/workspaces/<name>/: everything fx keeps for one workspace besides the
+// checkouts. The name is a path component, hence the guard.
+import path from 'node:path';
+import { assertWorkspaceName } from '../domain/workspace/name.js';
+export function localLayerPath(home, name) {
+    return path.join(workspaceHome(home, name), 'local.yaml');
+}
+export function manifestSourceDir(home, name) {
+    return path.join(workspaceHome(home, name), 'source');
+}
+function workspaceHome(home, name) {
+    assertWorkspaceName(name);
+    return path.join(home, 'workspaces', name);
+}
+//# sourceMappingURL=workspace-home.js.map

package/dist/infra/workspace-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-home.js","sourceRoot":"","sources":["../../src/infra/workspace-home.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4DAA4D;AAE5D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAY;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,IAAY;IAC/C,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/ports/activity.js

@@ -0,0 +1,5 @@
+// What fx is doing right now, told to whoever watches it work. Nothing said here is a
+// result or a record: a terminal shows it while it lasts, and a program reading the
+// streams sees none of it.
+export {};
+//# sourceMappingURL=activity.js.map

package/dist/ports/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/ports/activity.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,oFAAoF;AACpF,2BAA2B"}

package/dist/ports/agent-cleanup.js

@@ -0,0 +1,4 @@
+// Unpicking is global, so its hook cleanup spans registered workspaces. A
+// preview names the same targets as application without changing the selection.
+export {};
+//# sourceMappingURL=agent-cleanup.js.map

package/dist/ports/agent-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-cleanup.js","sourceRoot":"","sources":["../../src/ports/agent-cleanup.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,gFAAgF"}

package/dist/ports/agent-host.js

@@ -0,0 +1,4 @@
+// A coding agent as fx sees it: whether it is on this machine, and where it loads Skills
+// from.
+export {};
+//# sourceMappingURL=agent-host.js.map

package/dist/ports/agent-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-host.js","sourceRoot":"","sources":["../../src/ports/agent-host.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,QAAQ"}

package/dist/ports/ci.js

@@ -0,0 +1,4 @@
+// Where builds run: a platform that can also say how a job's last build
+// went. `release` asks it that, and nothing else.
+export {};
+//# sourceMappingURL=ci.js.map

package/dist/ports/ci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../../src/ports/ci.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,kDAAkD"}

package/dist/ports/clock.js

@@ -0,0 +1,4 @@
+// The current time as a port, so anything with a window — a cache entry, an
+// acknowledged setup step — can be tested without waiting it out.
+export {};
+//# sourceMappingURL=clock.js.map

package/dist/ports/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/ports/clock.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,kEAAkE"}

package/dist/ports/cluster.js

@@ -0,0 +1,3 @@
+// Where services run; only read-only operations are ever generated.
+export {};
+//# sourceMappingURL=cluster.js.map

package/dist/ports/cluster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.js","sourceRoot":"","sources":["../../src/ports/cluster.ts"],"names":[],"mappings":"AAAA,oEAAoE"}

package/dist/ports/code-host.js

@@ -0,0 +1,6 @@
+// Where repositories live. fx never talks to a code host's API itself; a provider drives
+// the host's own CLI. Readability has four states, and the query methods are read-only
+// and no wider than `release` needs: branches, a range between two of them, one commit,
+// one file at a ref.
+export {};
+//# sourceMappingURL=code-host.js.map

package/dist/ports/code-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-host.js","sourceRoot":"","sources":["../../src/ports/code-host.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,uFAAuF;AACvF,wFAAwF;AACxF,qBAAqB"}

package/dist/ports/contribution-git.js

@@ -0,0 +1,4 @@
+// Contribution Git has a private-index write surface, separate from sync. It
+// constructs a named branch without checkout, merge or changes to the real index.
+export {};
+//# sourceMappingURL=contribution-git.js.map

package/dist/ports/contribution-git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-git.js","sourceRoot":"","sources":["../../src/ports/contribution-git.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,kFAAkF"}

package/dist/ports/contribution-store.js

@@ -0,0 +1,4 @@
+// One workspace's contribution journal is replaced atomically while the
+// application holds its workspace/source leases. Absence is an empty journal.
+export {};
+//# sourceMappingURL=contribution-store.js.map

package/dist/ports/contribution-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-store.js","sourceRoot":"","sources":["../../src/ports/contribution-store.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,8EAA8E"}

package/dist/ports/contribution-transport.js

@@ -0,0 +1,4 @@
+// Source transport accepts an already verified personal-fork identity, then
+// rechecks local routing before asking or pushing one managed branch.
+export {};
+//# sourceMappingURL=contribution-transport.js.map

package/dist/ports/contribution-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-transport.js","sourceRoot":"","sources":["../../src/ports/contribution-transport.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,sEAAsE"}

package/dist/ports/diagnostics.js

@@ -0,0 +1,4 @@
+// Structured diagnostic events cross layer boundaries through this port;
+// producers know neither output format nor whether verbose output is enabled.
+export {};
+//# sourceMappingURL=diagnostics.js.map

package/dist/ports/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/ports/diagnostics.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,8EAA8E"}

package/dist/ports/error-tracker.js

@@ -0,0 +1,4 @@
+// Where runtime errors are collected: a platform that can also list what
+// is still unresolved in a project. `release` asks it that, and nothing else.
+export {};
+//# sourceMappingURL=error-tracker.js.map

package/dist/ports/error-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-tracker.js","sourceRoot":"","sources":["../../src/ports/error-tracker.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,8EAA8E"}

package/dist/ports/fs.js

@@ -0,0 +1,5 @@
+// The slice of a file system the use cases need: text and binary files,
+// directory copies and existence. An absent file reads as undefined rather than throwing, so
+// "optional document" is a plain branch, not an exception.
+export {};
+//# sourceMappingURL=fs.js.map

package/dist/ports/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/ports/fs.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,6FAA6F;AAC7F,2DAA2D"}

package/dist/ports/git.js

@@ -0,0 +1,6 @@
+// Git as sync and status need it, and nothing more: there is deliberately no checkout,
+// reset, stash, rebase or merge here, so "sync never destroys work" holds at the type
+// level. A fast-forward on the checked-out branch is the one merge that can happen, and
+// only when the tree is clean; on any other branch only the branch ref moves.
+export {};
+//# sourceMappingURL=git.js.map

package/dist/ports/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/ports/git.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,sFAAsF;AACtF,wFAAwF;AACxF,8EAA8E"}

package/dist/ports/harness-state.js

@@ -0,0 +1,4 @@
+// Projection ownership survives process interruption independently of native
+// files. The caller holds the workspace lease around read/plan/write sequences.
+export {};
+//# sourceMappingURL=harness-state.js.map

package/dist/ports/harness-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-state.js","sourceRoot":"","sources":["../../src/ports/harness-state.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF"}

package/dist/ports/hook-handler.js

@@ -0,0 +1,4 @@
+// Event handlers own their scheduling policy and status description. Dispatch
+// owns validation and transport, so adding an event does not add a host branch.
+export {};
+//# sourceMappingURL=hook-handler.js.map

package/dist/ports/hook-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-handler.js","sourceRoot":"","sources":["../../src/ports/hook-handler.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF"}

package/dist/ports/hook-protocol.js

@@ -0,0 +1,4 @@
+// A host codec plans text without touching disk or running commands. The
+// caller owns locks, trust, posture and persistence for every host format.
+export {};
+//# sourceMappingURL=hook-protocol.js.map

package/dist/ports/hook-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-protocol.js","sourceRoot":"","sources":["../../src/ports/hook-protocol.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2EAA2E"}

package/dist/ports/hook-state.js

@@ -0,0 +1,4 @@
+// Ownership and automatic-sync observations stay on the machine and are
+// excluded from exported profiles. Callers serialize compound updates.
+export {};
+//# sourceMappingURL=hook-state.js.map

package/dist/ports/hook-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-state.js","sourceRoot":"","sources":["../../src/ports/hook-state.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,uEAAuE"}

package/dist/ports/hook-tasks.js

@@ -0,0 +1,4 @@
+// Only the registered session-start background task can be launched. A
+// manifest command can never become a supervisor task or bypass its trust gate.
+export {};
+//# sourceMappingURL=hook-tasks.js.map

package/dist/ports/hook-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-tasks.js","sourceRoot":"","sources":["../../src/ports/hook-tasks.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,gFAAgF"}

package/dist/ports/identifiers.js

@@ -0,0 +1,4 @@
+// Opaque operation identifiers keep branch allocation independent of time and
+// make allocation deterministic in decision tests.
+export {};
+//# sourceMappingURL=identifiers.js.map

package/dist/ports/identifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["../../src/ports/identifiers.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mDAAmD"}

package/dist/ports/installer.js

@@ -0,0 +1,5 @@
+// How a companion tool gets onto the machine. An installer only assembles the vector;
+// running it is the use case's decision, after the dry-run and posture checks every
+// write goes through.
+export {};
+//# sourceMappingURL=installer.js.map

package/dist/ports/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/ports/installer.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,oFAAoF;AACpF,sBAAsB"}

package/dist/ports/lifecycle-runner.js

@@ -0,0 +1,4 @@
+// Supervised lifecycle workers return only a complete bounded payload.
+// A failed worker is an empty answer rather than a failed host session.
+export {};
+//# sourceMappingURL=lifecycle-runner.js.map

package/dist/ports/lifecycle-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-runner.js","sourceRoot":"","sources":["../../src/ports/lifecycle-runner.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wEAAwE"}

package/dist/ports/lock.js

@@ -0,0 +1,4 @@
+// A lease serializes a resource across processes. A bounded unsuccessful
+// acquisition is a value, allowing lifecycle callers to skip rather than wait.
+export {};
+//# sourceMappingURL=lock.js.map

package/dist/ports/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/ports/lock.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,+EAA+E"}

package/dist/ports/log-store.js

@@ -0,0 +1,3 @@
+// Where logs are searched.
+export {};
+//# sourceMappingURL=log-store.js.map

package/dist/ports/log-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-store.js","sourceRoot":"","sources":["../../src/ports/log-store.ts"],"names":[],"mappings":"AAAA,2BAA2B"}

package/dist/ports/manifest-source.js

@@ -0,0 +1,5 @@
+// Where a workspace's manifest comes from: a git repository, a directory whose files are
+// copied, or text on stdin. It is materialized into the workspace's source directory
+// under ~/.fx, never into the root. Only a repository source can refresh itself later.
+export {};
+//# sourceMappingURL=manifest-source.js.map

package/dist/ports/manifest-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-source.js","sourceRoot":"","sources":["../../src/ports/manifest-source.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,qFAAqF;AACrF,uFAAuF"}

package/dist/ports/mcp-codec.js

@@ -0,0 +1,4 @@
+// Codecs transform one native entry with explicit prior ownership evidence.
+// A digest identifies only the entry bytes, never the surrounding user document.
+export {};
+//# sourceMappingURL=mcp-codec.js.map

package/dist/ports/mcp-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-codec.js","sourceRoot":"","sources":["../../src/ports/mcp-codec.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,iFAAiF"}

package/dist/ports/metrics.js

@@ -0,0 +1,3 @@
+// Where service metrics are queried.
+export {};
+//# sourceMappingURL=metrics.js.map

package/dist/ports/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/ports/metrics.ts"],"names":[],"mappings":"AAAA,qCAAqC"}

package/dist/ports/platform.js

@@ -0,0 +1,5 @@
+// A platform instance from environments.yaml, alive: it turns the merged
+// variables of one environment into a coordinate. Each environment-scoped
+// capability names its own port so the registry can type them apart.
+export {};
+//# sourceMappingURL=platform.js.map

package/dist/ports/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/ports/platform.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0EAA0E;AAC1E,qEAAqE"}

package/dist/ports/process.js

@@ -0,0 +1,5 @@
+// The only way anything in fx starts a subprocess. Vectors go straight to
+// the executable as arguments. Windows batch shims require an adapter-owned
+// interpreter with escaping; callers cannot request raw shell evaluation.
+export {};
+//# sourceMappingURL=process.js.map

package/dist/ports/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/ports/process.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E"}

package/dist/ports/projection.js

@@ -0,0 +1,4 @@
+// Managed files are observed before planning and rechecked at application.
+// Foreign includes links and directories: a codec only receives regular text.
+export {};
+//# sourceMappingURL=projection.js.map

package/dist/ports/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/ports/projection.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8EAA8E"}

package/dist/ports/prompter.js

@@ -0,0 +1,5 @@
+// Asking a person something. Every method fails with INPUT_REQUIRED instead of hanging
+// when there is no person to ask, so a use case can ask freely and an agent still gets a
+// structured answer.
+export {};
+//# sourceMappingURL=prompter.js.map

package/dist/ports/prompter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompter.js","sourceRoot":"","sources":["../../src/ports/prompter.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,yFAAyF;AACzF,qBAAqB"}

package/dist/ports/provider.js

@@ -0,0 +1,6 @@
+// A provider is one implementation of a capability's port plus what fx needs to know to
+// wire it: the facts a manifest is read against, the tools it drives, the variables the
+// manifest must supply, and the setup steps it brings. Every adapter directory exports one
+// descriptor; the registry collects them.
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/ports/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/ports/provider.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,wFAAwF;AACxF,2FAA2F;AAC3F,0CAA0C"}

package/dist/ports/registry.js

@@ -0,0 +1,5 @@
+// The configured package registry, asked one thing: the newest
+// released version of a package. Any failure is thrown; the caller decides
+// how quiet to be about it.
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/ports/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/ports/registry.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2EAA2E;AAC3E,4BAA4B"}

package/dist/ports/replace-files.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=replace-files.js.map

package/dist/ports/replace-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-files.js","sourceRoot":"","sources":["../../src/ports/replace-files.ts"],"names":[],"mappings":""}

package/dist/ports/reporter.js

@@ -0,0 +1,3 @@
+// Format-independent workflow notices and progress events.
+export {};
+//# sourceMappingURL=reporter.js.map

package/dist/ports/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/ports/reporter.ts"],"names":[],"mappings":"AAAA,2DAA2D"}

package/dist/ports/service-protocol.js

@@ -0,0 +1,4 @@
+// Decode a companion's public service plan without exposing its response format
+// to preparation workflows. Only approved public changes cross this boundary.
+export {};
+//# sourceMappingURL=service-protocol.js.map

package/dist/ports/service-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-protocol.js","sourceRoot":"","sources":["../../src/ports/service-protocol.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E"}

package/dist/ports/snapshot-views.js

@@ -0,0 +1,4 @@
+// A candidate view exposes only captured bytes. It cannot fall through to a
+// checkout or provide write methods to manifest inspection.
+export {};
+//# sourceMappingURL=snapshot-views.js.map

package/dist/ports/snapshot-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-views.js","sourceRoot":"","sources":["../../src/ports/snapshot-views.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4DAA4D"}

package/dist/ports/stores.js

@@ -0,0 +1,3 @@
+// Ports for personal configuration, workspace selections, command trust and caches.
+export {};
+//# sourceMappingURL=stores.js.map

package/dist/ports/stores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.js","sourceRoot":"","sources":["../../src/ports/stores.ts"],"names":[],"mappings":"AAAA,oFAAoF"}

package/dist/ports/tool-history.js

@@ -0,0 +1,3 @@
+// Durable append-only installation checkpoints, shared by workspaces under one FX_HOME.
+export {};
+//# sourceMappingURL=tool-history.js.map

package/dist/ports/tool-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-history.js","sourceRoot":"","sources":["../../src/ports/tool-history.ts"],"names":[],"mappings":"AAAA,wFAAwF"}