@owlmeans/viable-common 0.0.4

package/build/skills/roles.js.map

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

package/build/slot/consts.d.ts

@@ -0,0 +1,305 @@
+/**
+ * The slot command vocabulary — what one process asks another to do to a target project's tree.
+ *
+ * It lives here, beside the target-shape manifest and the metadata layout, because THREE
+ * independent executors answer it and none of them owns it: the publisher inside an ephemeral or
+ * production pod, the agent's remote helper that speaks to that publisher, and the connector SDK
+ * that executes the same commands on a developer's own machine. A vocabulary owned by one of them
+ * is a vocabulary the other two copy, and a copied enum drifts silently — the last time a role
+ * vocabulary was duplicated, one copy answered `common` for every role the other had added and
+ * type checks ran against the wrong package with nothing failing.
+ */
+/**
+ * Which workload a slot record describes.
+ *
+ * `Ephemeral` is the live-preview pod (publisher + one-shot builds + SSE reload), `Production`
+ * the hardened pod that serves real end users from prebuilt artifacts, and `Local` a target
+ * project that lives on a developer's own machine and has no pod at all — its file, shell and git
+ * commands are executed by the connector on that machine, and nothing about it is provisioned,
+ * routed, reconciled or published.
+ */
+export declare enum WorkloadKind {
+    Ephemeral = "ephemeral",
+    Production = "production",
+    /**
+     * The target project is on the user's disk, reached through a connector session.
+     *
+     * A slot record still exists — it is what carries the project's slug, its OIDC client and its
+     * configuration — but it owns no namespace, no volume, no hostname and no certificate. Every
+     * cloud-only operation (run/stop/restart the sandbox, publish, push to a remote, watch files)
+     * refuses for it rather than half-working.
+     */
+    Local = "local"
+}
+export declare enum SlotCommandType {
+    Files = "files",
+    Shell = "shell",
+    Git = "git"
+}
+export declare enum SlotGitCommand {
+    Ensure = "ensure",
+    /**
+     * Bring a remote repository's tree onto a volume that already exists.
+     *
+     * NOT `git clone`: a slot's directory is never empty — provisioning leaves its own metadata
+     * there — and `git clone` refuses a non-empty destination. The executor therefore initializes,
+     * adds the remote, fetches at a bounded depth and checks the branch out over the tree.
+     */
+    Clone = "clone",
+    Status = "status",
+    Commit = "commit",
+    Log = "log",
+    Discard = "discard",
+    RevertTo = "revertTo",
+    SetRemote = "setRemote",
+    Push = "push",
+    Pull = "pull"
+}
+export declare enum SlotFileCommand {
+    EmptyProject = "emptyProject",
+    DeleteProject = "deleteProject",
+    InitializeProject = "initializeProject",
+    GetSourceList = "getSourceList",
+    GetStructuredList = "getStructuredList",
+    ReadFile = "readFile",
+    ReadSource = "readSource",
+    ReadPossibleSource = "readPossibleSource",
+    ReadSources = "readSources",
+    WriteFile = "writeFile",
+    WriteSource = "writeSource",
+    DeleteFile = "deleteFile",
+    FindFilesWithEnvVars = "findFilesWithEnvVars",
+    GetRootPath = "getRootPath",
+    /**
+     * List a tree with a size and a binary flag per entry, bounded by a caller-given limit.
+     *
+     * The reason it exists rather than being composed out of {@link SlotFileCommand.GetSourceList}
+     * plus a read per file: a foreign repository can hold a hundred thousand files, and one round
+     * trip each — over a signed HTTP call to a pod, or over a connector on somebody's laptop — is
+     * not a slower version of the same thing, it is a walk that never finishes.
+     */
+    StatTree = "statTree",
+    /**
+     * Read the first N bytes of one file.
+     *
+     * A census classifies a file from its head; reading whole files to do it would hold a 1 MB
+     * export in memory to look at its first line. The answer is text, so a binary head comes back
+     * as whatever decoding produced — which is exactly the signal the entropy classification wants.
+     */
+    ReadHead = "readHead",
+    /**
+     * Move everything in the project root into a subdirectory, keeping a named few in place.
+     *
+     * One command rather than a listing plus a move per file, because it must be ATOMIC from the
+     * caller's point of view: a relocation interrupted half way leaves a tree that is neither the
+     * origin nor a target, and nothing downstream can tell which files already moved. Binary-safe —
+     * it moves paths and never reads contents.
+     */
+    Relocate = "relocate",
+    /** Delete a directory and everything under it. The purge of a relocated origin. */
+    RemoveTree = "removeTree"
+}
+export declare enum SlotShellCommand {
+    Bun = "bun",
+    /**
+     * Re-resolve every dependency from scratch, then install.
+     *
+     * NOT `bun install` — that reproduces the lockfile, which is the whole problem. A target's
+     * `@owlmeans/*` ranges are carets, but its lockfile was written once at project init and pins
+     * the versions that were current that day; a republished framework fix therefore never reaches
+     * a slot that already exists, however many times it is rebuilt. Truncating the lockfile first
+     * is what project initialization does, so a reinstalled slot converges on the dependency state
+     * a freshly created one would have.
+     *
+     * It is deliberately NOT part of {@link SlotShellCommand.Build}: that runs after every agent
+     * file write and has to stay seconds long. This is minutes, and only a user asking for it.
+     */
+    Reinstall = "reinstall",
+    BuildCommon = "buildCommon",
+    Validate = "validate",
+    ValidateWithRenderer = "validateWithRenderer",
+    Build = "build",
+    /**
+     * Reconcile the target's database with its code.
+     *
+     * The target owns its own structure: every `@owlmeans/postgres` resource creates and updates its
+     * table while the OwlMeans context initializes. So a sync is not a command run against the source
+     * tree — it is *bootstrap the role/database if needed, then restart the backend* and report
+     * whatever DDL or migration error the boot produced. There is nothing to generate and no
+     * migration file to apply.
+     */
+    DbSync = "dbSync",
+    /** Rollup-build the backend only — the type check the frontend renderer build cannot give it. */
+    ValidateBackend = "validateBackend",
+    /**
+     * Boot the target backend for real, in isolation, and report why it failed.
+     *
+     * A foreign key that names a resource nothing registers, a service alias nobody provides, a
+     * context that wedges on init — none of it is visible to `tsc`, and all of it kills the app at
+     * startup. The check runs a SECOND backend process on its own port against a scratch schema,
+     * reads the target's own health verdict and kills it again, so the serving backend and the
+     * live preview are untouched.
+     *
+     * The command STARTS the check and returns immediately (`{ result: null, started: true }`);
+     * the verdict is read with {@link SlotShellCommand.BootCheckStatus}. A boot is minutes of
+     * build + startup, and holding one HTTP request open for it made a slot fault indistinguishable
+     * from a hung agent for the whole of the caller's timeout. A second start while one runs joins
+     * the running check rather than spawning another instance onto the port.
+     */
+    BootCheck = "bootCheck",
+    /**
+     * Report the boot check started by {@link SlotShellCommand.BootCheck}:
+     * `{ running, startedAt, report }`. `report` is the last completed verdict, so a poll that
+     * arrives after completion still gets the answer.
+     */
+    BootCheckStatus = "bootCheckStatus",
+    /**
+     * Report whether the sandbox still holds the generated application.
+     *
+     * Structural, cheap and model-free: a handful of file reads checked against
+     * `TARGET_INTEGRITY_FILES`. It exists as a command because the publisher is the only process
+     * with the volume in front of it, and the agent needs the same answer before it lets a git
+     * merge reach a build. The publisher enforces the manifest on its own before every spawn
+     * regardless — this command is how a caller asks first rather than finding out from a
+     * failed build.
+     */
+    Integrity = "integrity"
+}
+/**
+ * A ROLE in the target project, as it travels on the wire.
+ *
+ * Not a directory name. A role is resolved to a directory per LAYOUT (see `./layout.js`); nothing
+ * may join these values onto a path.
+ *
+ * Two generations of vocabulary live here at once, and both arrive over the wire. `Frontend` and
+ * `Backend` are v1's names — "the browser side" and "the server side" — and every already-published
+ * slot still speaks them. `Api`, `Web` and `Worker` are what the current agent library sends, and
+ * `Backend` means something DIFFERENT to it: v2 split the server in two, so `backend` is the shared
+ * library that `api` and `worker` compile against, and `api` is the HTTP server. That is why the
+ * mapping is per-layout rather than a rename.
+ *
+ * Every value any sender can produce must be a member. It was the three v1 names alone while the
+ * library had already moved to five, and the role→directory fall-through then answered `common`
+ * for `api`, `web` and `worker` alike — so a type check ran against the shared package instead of
+ * the one under repair. Nothing failed; the answers were simply about another package.
+ */
+export declare enum SubProject {
+    Common = "common",
+    /** v1: the browser app. v2 sends {@link Web} instead; kept because old slots still send this. */
+    Frontend = "frontend",
+    /** v1: the HTTP server. v2: the shared library `api` and `worker` are built against. */
+    Backend = "backend",
+    /** v2: the HTTP server. */
+    Api = "api",
+    /** v2: the browser app. */
+    Web = "web",
+    /** v2: the queue consumer. */
+    Worker = "worker"
+}
+/**
+ * The ports a generated target binds, and the marker that tells its two identical processes apart.
+ *
+ * They are contract, not preference: the publisher composes the pod's environment from them, the
+ * connector composes a local `.env` from the same values, and the target's own configuration reads
+ * them back. A local run and a slot run therefore address the app the same way.
+ */
+export declare const TARGET_API_PORT = 3000;
+export declare const TARGET_WEB_PORT = 5173;
+export declare const TARGET_WORKER_PORT = 3003;
+export declare const TARGET_API_BASE = "api";
+/** The argv marker separating the worker process from the api's — both run the same `dist/index.js`. */
+export declare const TARGET_WORKER_MARKER = "--viable-worker";
+/**
+ * The api's own marker, so a leftover can be told from the worker and the boot check.
+ *
+ * All three run `bun dist/index.js`, and reclaiming a port by that alone would kill whichever of
+ * them happened to match. Only a LOCAL run passes it — in a pod the process is the container's and
+ * a restart is Kubernetes's business.
+ */
+export declare const TARGET_API_MARKER = "--viable-api";
+/** Port and schema the isolated boot check uses, so it never touches the serving backend. */
+export declare const TARGET_BOOTCHECK_PORT = 3100;
+export declare const TARGET_BOOTCHECK_SCHEMA = "bootcheck";
+export declare const TARGET_BOOTCHECK_MARKER = "--viable-boot-check";
+/**
+ * The address a LOCAL target answers at.
+ *
+ * Stored on the slot record as `host` at creation and read back from there by everything that
+ * routes, redirects or previews — never recomposed. A local slot's origin is `http://` because it
+ * is a loopback address; every other slot kind is `https://`.
+ */
+export declare const LOCAL_SLOT_HOST = "localhost:5173";
+/**
+ * EXECUTOR-side ceilings: how long the process holding the tree may spend on one command.
+ *
+ * Applied by whoever actually runs the command — the publisher in a pod, the connector on a
+ * developer's machine — so a wedged build fails the request instead of holding it open forever.
+ */
+export declare const COMMAND_DEADLINES: Record<string, number>;
+export declare const DEFAULT_COMMAND_DEADLINE = 60000;
+/**
+ * EXECUTOR-side ceilings for the git commands whose real duration is not a git command's.
+ *
+ * Everything git does inside a slot is local and takes seconds — except a clone, which is a
+ * network fetch of somebody else's repository and is measured in minutes. Bounding it by the
+ * generic git deadline made a conversion's very first step fail on any repository large enough
+ * to be worth converting.
+ */
+export declare const GIT_COMMAND_DEADLINES: Partial<Record<SlotGitCommand, number>>;
+/** What every other git command gets. The value the type-level branch used to hard-code. */
+export declare const DEFAULT_GIT_COMMAND_DEADLINE = 60000;
+/**
+ * EXECUTOR-side ceilings for the file commands that walk or move a whole tree.
+ *
+ * The other file commands are one path each and finish in milliseconds; these three are bounded
+ * by how big the tree is, which for an origin project is set by whoever wrote it.
+ */
+export declare const FILE_COMMAND_DEADLINES: Partial<Record<SlotFileCommand, number>>;
+/** What every other file command gets. The value the type-level branch used to hard-code. */
+export declare const DEFAULT_FILE_COMMAND_DEADLINE = 30000;
+/**
+ * CALLER-side ceilings per command type: how long the asker waits for an answer.
+ *
+ * Deliberately separate from {@link COMMAND_DEADLINES} and deliberately larger — the caller's
+ * bound must outlast the executor's, or a command that failed cleanly inside its own deadline
+ * reaches the caller as a timeout and the real reason is lost.
+ */
+export declare const COMMAND_TIMEOUTS: Partial<Record<SlotCommandType, number>>;
+export declare const DEFAULT_COMMAND_TIMEOUT = 60000;
+/**
+ * Per-COMMAND caller ceilings, for the shell commands whose real duration is known.
+ *
+ * The type-level ceiling has to cover `bun install`, so every shell command inherited twenty
+ * minutes — including a boot check the executor itself caps at eight, and a build it caps at
+ * five. When one of them wedged, the caller waited out the twenty regardless, and the story it
+ * belonged to sat frozen for the whole of it. A command with a known duration gets a bound close
+ * to that duration; anything not listed keeps the generous type default, which is what an
+ * install still needs.
+ */
+export declare const SHELL_COMMAND_TIMEOUTS: Record<string, number>;
+/**
+ * Per-COMMAND caller ceilings for git and for files.
+ *
+ * Each is its executor deadline plus the same 40 s margin: the caller's bound must outlast the
+ * executor's, or a command that failed cleanly inside its own deadline reaches the caller as a
+ * timeout and the real reason — the one the executor took the trouble to produce — is lost.
+ */
+export declare const GIT_COMMAND_TIMEOUTS: Partial<Record<SlotGitCommand, number>>;
+export declare const FILE_COMMAND_TIMEOUTS: Partial<Record<SlotFileCommand, number>>;
+/**
+ * Resolve the caller-side bound for one command.
+ *
+ * One function rather than three lookups at each call site: an asker that forgets the per-command
+ * table inherits twenty minutes for a fifteen-second command, which is the failure this table was
+ * added to stop.
+ */
+export declare const commandTimeout: (type: SlotCommandType, command: string, override?: number) => number;
+/**
+ * Resolve the executor-side deadline for one command.
+ *
+ * Per-command first, per-type second. It was per-type only, which is how a clone inherited the
+ * bound of a `git status` — the same shape as the shell table above, and added for the same
+ * reason.
+ */
+export declare const commandDeadline: (type: SlotCommandType, command: string) => number;
+//# sourceMappingURL=consts.d.ts.map

package/build/slot/consts.d.ts.map

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