vibe64 0.1.34 → 0.1.36

package/node_modules/@local/vibe64-genesis/package.json

@@ -5,6 +5,7 @@
   "type": "module",
   "exports": {
     "./server": "./src/server/index.js",
+    "./server/agentSpecs": "./src/server/agentSpecs.js",
     "./server/promptContext": "./src/server/promptContext.js",
     "./shared/connectedPackageTypes": "./src/shared/connectedPackageTypes.js"
   }

package/node_modules/@local/vibe64-genesis/src/server/agentSpecs.js

@@ -0,0 +1,255 @@
+import { createRequire as __vibe64CreateRequire } from 'node:module';const require=__vibe64CreateRequire(import.meta.url);
+import{ARCHITECTURE_OBSERVATIONS_SCHEMA as Z}from"genesis-compiler";var te=Object.freeze({VIBE64_WORKSPACE_SETUP_INVALID:"workspace-setup",VIBE64_OUTPUTS_INVALID:"outputs",VIBE64_DEPLOYMENT_INVALID:"\
+deployment",VIBE64_RESOURCE_ESTIMATES_INVALID:"resource-estimates",VIBE64_CONNECTED_DEVELOPMENT_INVALID:"connected-devel\
+opment",VIBE64_PROJECT_SERVICES_INVALID:"project-services",VIBE64_INTEGRATION_SETUP_INVALID:"integration-setup",VIBE64_ARCHITECTURE_INSPECTION_INVALID:"\
+architecture-inspection",VIBE64_ARCHITECTURE_LAYOUT_INVALID:"architecture-layout"});var B="- Recreate on restore: ",W=Object.freeze({prepare:0,build:1,migrate:2,serve:3}),f=Object.keys(W).map(e=>e[0].toUpperCase()+
+e.slice(1)),I=Object.freeze(["- Workdir: `path`","- Runtimes: `runtime`...",`${B}\`glob\`...`,"- Ready when: `GET` `/pat\
+h` returns `200`",`- ${f.join("|")} \`label\`: \`command\` \`argument\`...`]);var h=Object.freeze({Runtime:["runtimeRequirements","`runtime`..."],Directory:["workdir","`path`"],Command:["argv","`com\
+mand` `argument`..."],"Timeout seconds":["timeout","`1` through `60`"],"Max output bytes":["maxBuffer",`\`1\` through \`${4*
+1024*1024}\``],"Entry files":["entryFiles","`path`... (optional)"],"Required files":["requiredFiles","`path`... (optiona\
+l)"]}),oe=new RegExp(`^- (${Object.keys(h).join("|")}): (.+)$`,"u");var O=Object.freeze(["layer","libraries","support"]);var _="- Prepare `label` with `runtime` [in `workdir`] [when|if `path` exists]: `command` `argument`...";var H="custom",k="vibe64.connected-sources.v1",g=Object.freeze([Object.freeze({value:"npm",label:"npm (Node.js)"}),Object.
+freeze({value:"composer",label:"Composer (PHP)"}),Object.freeze({value:"pip",label:"pip (Python)"}),Object.freeze({value:"\
+bundler",label:"Bundler (Ruby)"}),Object.freeze({value:"gomod",label:"Go modules"}),Object.freeze({value:"cargo",label:"\
+Cargo (Rust)"}),Object.freeze({value:"maven",label:"Maven"}),Object.freeze({value:"gradle",label:"Gradle"}),Object.freeze(
+{value:"nuget",label:"NuGet (.NET)"}),Object.freeze({value:H,label:"custom"})]),N="Vibe64's preparer appends the absolut\
+e script path and --phase prepare|verify, --source-root <receiving source>, --project-root <consuming project>, --source\
+s-file <absolute Sources file> and --repository <GitHub URL> arguments to the Stack's Custom runner command, once per ph\
+ase; execution checks the script remains inside the consuming project.",de=Object.freeze(g.map(e=>e.value));var E="with `runtime` [in `workdir`]: `command` `argument`...",A=Object.freeze(["- Default package type: `type`","- Sour\
+ces file: `path`",`- Prepare \`label\` ${E}`,`- Verify \`label\` ${E}`,`- Custom runner ${E}`]);var D="- Command with `runtime` in `workdir`: `command` `argument`...";var T="vibe64.preview-identity.command.v1";var C=new Set(["HOME","LOGNAME","NODE_OPTIONS","PATH","TMPDIR","USER"]),z=new Set(["email","login","user-id"]),G=new Set(
+["finite","interactive"]),F=new Set(["development","test"]),K=new Set(["terminal","web"]),$=16,Y=1e4,X=3e4,y=e=>[...e].map(
+n=>`\`${n}\``).join(" or "),J=[["- Command: ","command","Command","`tools/preview-identity` `argument`..."],["- Protocol\
+: ","protocol","Protocol",`\`${T}\``],["- Identity types: ","identityTypes","Identity types",`one or more of ${[...z].map(
+e=>`\`${e}\``).join(" ")}`],["- Enabled environment: ","enabledEnvironment","Enabled environment","`ENV_NAME`"],["- Secr\
+et environment: ","secretEnvironment","Secret environment","`ENV_NAME`"],["- Runtimes: ","runtimes","Runtimes","`runtime\
+`..."],["- Timeout ms: ","timeoutMs","Timeout ms",`\`1\` through \`${X}\` (default ${Y})`]],M=Object.freeze(["### Target\
+ `id`: Label","#### Parameter `id`: Label","#### Presentation","#### Preview identity","#### Download `id`"]),c=Object.freeze(
+{target:["- Default.",`- Mode: ${y(G)}`,`- Data: ${y(F)}`,"- Workdir: `path`","- Runtimes: `runtime`...","- Prepare|Buil\
+d|Run `label`: `command` `argument`..."],parameter:["- Default: `text`","- Description: `text`","- Required."],presentation:[
+`- Kind: ${y(K)}`,"- Preferred port: `1024` through `65535`","- URL path: `/path`","- Ready when: `GET` `/path` returns \
+`200`"],previewIdentity:J.map(([e,,,n])=>`${e}${n}`),download:["- Path: `path`","- Name: `file-name`","- Media type: `ty\
+pe/subtype`"]});var x="- Start `service-id` [per session] with `runtime` [in `workdir`]: `command` `argument`...";var De=1024*1024,V=1024*1024,P=new Map([["Startup typical MiB","startupTypical"],["Startup high MiB","startupHigh"],["Ru\
+nning typical MiB","runningTypical"],["Running high MiB","runningHigh"],["Typical MiB","typical"],["High MiB","high"]]);var Q=["Command values: the executable and every argument are separate backticked values separated by single spaces (at \
+most 64 values of at most 4096 characters, no line breaks). The executable is a name on PATH or a project-relative path,\
+ never absolute and never containing `..`.","Runtimes are lowercase technology ids selected in the project's Stack, such\
+ as `nodejs` or `php`. Paths are canonical project-relative paths; `.` is the project root.","A section containing only \
+`- Nothing.` explicitly declares nothing. Blank lines are ignored."].join(`
+`),t=e=>e.map(n=>`    ${n}`).join(`
+`);function i({name:e,title:n,section:l,contract:b="",summary:j,body:L,example:R}){return{name:e,title:n,section:l,example:R,
+text:()=>[`# ${n}`,"",`Section: \`## ${l}\` in \`genesis/stack.md\`${b?`, contract \`${b}\``:""}. Vibe64 owns its gramma\
+r and meaning; Genesis transports the exact section text.`,"",j,"",L.trim(),"",Q,"","## Example","","```markdown",`## ${l}`,
+"",R.trim(),"```",""].join(`
+`)}}var ee=`
+### Target \`app\`: Application
+
+- Default.
+- Mode: \`interactive\`
+- Runtimes: \`nodejs\`
+- Run \`Start\`: \`npm\` \`run\` \`dev\` \`--\` \`--host\` \`{host}\` \`--port\` \`{port}\`
+
+#### Presentation
+
+- Kind: \`web\`
+- URL path: \`/\`
+- Ready when: \`GET\` \`/health\` returns \`200\`
+
+#### Preview identity
+
+- Command: \`tools/preview-identity\`
+- Protocol: \`${T}\`
+- Identity types: \`email\`
+- Enabled environment: \`APP_PREVIEW_IDENTITY_ENABLED\`
+- Secret environment: \`APP_PREVIEW_IDENTITY_SECRET\`
+- Runtimes: \`nodejs\`
+
+### Target \`test-app\`: Test Preview
+
+- Mode: \`interactive\`
+- Data: \`test\`
+- Runtimes: \`nodejs\`
+- Run \`Start test application\`: \`node\` \`tests/support/start-test-app.mjs\` \`{host}\` \`{port}\`
+
+#### Presentation
+
+- Kind: \`web\`
+- Ready when: \`GET\` \`/health\` returns \`200\`
+
+### Target \`report\`: Monthly report
+
+- Mode: \`finite\`
+- Runtimes: \`nodejs\`
+- Build \`Export\`: \`node\` \`tools/export.mjs\` \`--month\` \`{parameter:month}\`
+
+#### Parameter \`month\`: Month
+
+- Default: \`2026-01\`
+- Description: \`Month to export.\`
+- Required.
+
+#### Download \`csv\`
+
+- Path: \`exports/report.csv\`
+- Name: \`report.csv\`
+- Media type: \`text/csv\`
+`,qe=Object.freeze([i({name:"workspace-setup",title:"Workspace setup",section:"Workspace setup",contract:"vibe64.workspa\
+ce-setup.v1",summary:"Ordered commands that prepare a session's working copy (dependencies, generated files, migrations)\
+ before any Output runs.",body:`
+Each entry:
+${t([_])}
+
+- \`\` in \`workdir\` \`\` runs the command in that project directory (default \`.\`).
+- \`\` when \`path\` exists \`\` waits: setup stays waiting until the path exists (for example a manifest the agent has not cr\
+eated yet).
+- \`\` if \`path\` exists \`\` skips the step while the path is missing.
+- Steps run in order through managed execution with the session's development Env. Vibe64 records success against the ex\
+act recipe; changing any step runs setup again, and Outputs stay pending until it succeeds. Keep every step repeatable a\
+nd non-destructive.
+`,example:"\n- Prepare `Install dependencies` with `nodejs`: `npm` `ci`\n- Prepare `Migrate database` with `nodejs` if `mi\
+grations` exists: `npm` `run` `db:migrate`\n- Prepare `Install client` with `nodejs` in `client` when `client/package.jso\
+n` exists: `npm` `ci`\n"}),i({name:"outputs",title:"Outputs",section:"Outputs",contract:"vibe64.outputs.v1",summary:"The\
+ runnable targets Vibe64 offers: interactive terminal or web apps shown in Preview, and finite runs that produce downloa\
+ds.",body:`
+Headings, each target followed by its entries and then optional blocks:
+${t(M)}
+
+Target entries:
+${t(c.target)}
+
+- Ids use lowercase letters, digits and single hyphens. Target ids are unique; at most one target is \`- Default.\` (the n\
+ormal Preview).
+- \`interactive\`: exactly one Run step, last, and one \`#### Presentation\`. \`finite\`: no Run, Presentation or Preview iden\
+tity, and at least one \`#### Download\`.
+- Steps are ordered Prepare, Build, then Run. \`{host}\` and \`{port}\` may appear only in a web target's Run step; the appl\
+ication must listen there. \`{parameter:id}\` may appear in any step argument.
+- \`\` - Data: \`test\` \`\` declares a target that enforces isolated test data (Test Preview banner; used by \`vibe64-helper p\
+laywright --target <id>\`). \`development\` is the other value; omitting Data asserts nothing.
+- Workdir defaults to \`.\`.
+
+\`#### Parameter\` entries (at most ${$} per target, each used in a step):
+${t(c.parameter)}
+
+Values are single-line text of at most 4096 characters; an omitted Default is empty; Required rejects blank values. Para\
+meters are visible arguments: keep credentials in Env.
+
+\`#### Presentation\` entries:
+${t(c.presentation)}
+
+\`terminal\` accepts only Kind. \`web\` needs one Ready when (status 200 through 399); URL path defaults to \`/\`.
+
+\`#### Download\` entries (all required):
+${t(c.download)}
+
+Path is a project-relative file the steps produce; Name is a safe file name of at most 255 characters; Media type is low\
+ercase type/subtype.
+
+\`#### Preview identity\` entries (web targets only; Command, Protocol and Identity types are required):
+${t(c.previewIdentity)}
+
+- The command is a committed, application-owned project-relative executable whose path contains \`/\`, without \`{host}\` or\
+ \`{port}\`.
+- Enabled and Secret environment names are distinct uppercase names, not ${[...C].join(", ")} or \`XDG_*\`. For an enabled\
+ web run Vibe64 sets the enabled name to \`true\` and the secret name to a fresh per-run secret; the application must keep\
+ its identity exchange disabled unless both are present.
+- The command's stdin/stdout protocol: \`vibe64-helper spec preview-identity-command\`. The configured account names: \`vib\
+e64-helper spec preview-identities\`.
+`,example:ee}),i({name:"deployment",title:"Deployment",section:"Deployment",contract:"vibe64.application-deployment.v1",
+summary:"The commands that turn a project revision into a running production application.",body:`
+Entries:
+${t(I)}
+
+- Steps are ordered ${f.join(", ")}; exactly one Serve step comes last. Serve starts the long-running application, which\
+ listens on the address given by the \`HOST\` and \`PORT\` environment variables. Arguments are passed literally (no \`{host}\
+\` or \`{port}\` placeholders), so a server that takes its address only as arguments needs a committed project script that \
+reads them.
+- One Ready when entry is required (status 200 through 399). Workdir defaults to \`.\`. Each other entry appears at most o\
+nce.
+- Recreate on restore lists project-relative globs (only \`*\` and \`**\`) that a restored deployment rebuilds with its Prep\
+are step, such as installed dependencies. It requires a Prepare step.
+- Migrate applies pending migrations without destroying data.
+`,example:"\n- Runtimes: `nodejs`\n- Recreate on restore: `node_modules`\n- Prepare `Install`: `npm` `ci`\n- Build `Build`: \
+`npm` `run` `build`\n- Migrate `Migrate`: `npm` `run` `db:migrate`\n- Serve `Serve`: `node` `server.js`\n- Ready when: `GET\
+` `/health` returns `200`\n"}),i({name:"resource-estimates",title:"Resource estimates",section:"Resource estimates",contract:"\
+vibe64.resource-estimates.v1",summary:"Optional memory planning hints for Outputs and Workspace setup. They are not obse\
+rved usage, reservations, minimum requirements or granted limits; the execution host owns those choices.",body:`
+Headings: \`\` ### Output \`id\` \`\` (an id declared in Outputs) or \`### Workspace setup\` (requires declared setup steps), ea\
+ch followed by fields:
+${t([...P.keys()].map(e=>`- ${e}: \`number\``))}
+
+- An interactive output declares the four Startup and Running fields. A finite output and Workspace setup declare only T\
+ypical MiB and High MiB.
+- Values are integer MiB from 1 through ${V}; typical never exceeds high. Duplicate operations or fields and unknown fie\
+lds are rejected. The section is at most 64 KiB and 2048 lines.
+- Invalid estimates never change Outputs availability or setup readiness; the host then uses its generic policy. Changin\
+g only estimates does not rerun setup.
+`,example:"\n### Output `app`\n\n- Startup typical MiB: `1024`\n- Startup high MiB: `1536`\n- Running typical MiB: `768`\n- Ru\
+nning high MiB: `1536`\n\n### Workspace setup\n\n- Typical MiB: `1024`\n- High MiB: `1536`\n"}),i({name:"connected-devel\
+opment",title:"Connected development",section:"Connected development",contract:"vibe64.connected-development.v1",summary:"\
+How this project consumes the working source of connected projects (its own dependencies under development) in a session\
+.",body:`
+Entries:
+${t(A)}
+
+- Declare a Default package type alone, or a Sources file with Verify entries or a Custom runner (keeping any Default pa\
+ckage type). All Prepare entries precede Verify entries. Steps run unconditionally (no \`when\`/\`if\`); at most one Custom \
+runner.
+- Package types: ${g.map(({value:e})=>`\`${e}\``).join(", ")}. A type is a declared label: Vibe64 never runs a package m\
+anager for it. This project's own Prepare/Verify commands give each connected source its ecosystem's treatment, and Veri\
+fy must prove that the source is consumed.
+- The Sources file is a development-only path outside \`.git\`, never tracked; Vibe64 writes it when it prepares connected\
+ sources and excludes it from Git. Its JSON: \`{"contract":"${k}","sessionId":"\u2026","projects":[{"name":"\u2026","repository":"\
+https://github.com/owner/repo","relationship":"dependency|composition","type":"npm","sourceRoot":"/absolute/receiving/so\
+urce","contributionId":"\u2026"}]}\`; a custom connection also carries \`"script"\`.
+- Custom connections: ${N}
+`,example:"\n- Default package type: `npm`\n- Sources file: `.connected-sources.json`\n- Prepare `Link connected packages` \
+with `nodejs`: `node` `tools/link-connected.mjs`\n- Verify `Check connected packages` with `nodejs`: `node` `tools/verify\
+-connected.mjs`\n"}),i({name:"project-services",title:"Project services",section:"Project services",contract:"vibe64.pro\
+ject-services.v1",summary:"Foreground helper processes (workers, local reference services) that Vibe64 starts before an \
+Output.",body:`
+Entries:
+${t([x])}
+
+- Service ids are unique, start with a lowercase letter and use up to 64 lowercase letters, digits and hyphens. Workdir \
+defaults to \`.\`.
+- Without \`per session\` all sessions share one instance; with it each session gets its own instance in its own source di\
+rectory.
+- Services run with the project's development Env, stay in the foreground and release everything they own on SIGTERM. Ne\
+ver spawn untracked background work.
+- Vibe64 owns process lifetime, not the network protocol: allocate a distinct endpoint (for example bind port 0 and reco\
+rd the address in the session's ignored runtime folder) and check your own instance's readiness. Never assume a shared f\
+ixed port.
+`,example:"\n- Start `worker` with `nodejs` in `tools`: `npm` `run` `worker`\n- Start `reference` per session with `nodejs\
+`: `npm` `run` `reference:service`\n"}),i({name:"integration-setup",title:"Integration setup",section:"Integration setup",
+contract:"vibe64.integration-setup.v1",summary:"The one application-owned command the editor's Integrations controls cal\
+l to configure, connect and check the application's external integrations.",body:`
+Exactly one entry:
+${t([D])}
+
+The command's request/response protocol and the \`integrations.json\` usage: \`vibe64-helper spec integration-setup-command\
+\`.
+`,example:"\n- Command with `nodejs` in `.`: `node` `scripts/integrations.js`\n"}),i({name:"architecture-inspection",title:"\
+Architecture inspection",section:"Architecture inspection",contract:"vibe64.architecture-inspection.v1",summary:"Optiona\
+l project-owned inspectors that the Architecture view runs to observe the application's structure (pages, routes, entry \
+points).",body:`
+Headings: \`\` ### Inspector \`id\`: Title \`\`, each followed by fields:
+${t(Object.entries(h).map(([e,[,n]])=>`- ${e}: ${n}`))}
+
+- Every field except Entry files and Required files is required; ids are unique. The Runtime must be selected in the Sta\
+ck.
+- Reading declarations runs nothing. Entry files name application entry points. Required files must exist as regular pro\
+ject files before the inspector runs.
+- On analysis the command receives one \`vibe64.architecture-inspection-input.v1\` JSON request on stdin (files with hashe\
+s, packages, package identity, UI discovery and the Stack hash) and must print one \`${Z}\` JSON document; Genesis owns t\
+hat observation schema.
+`,example:"\n### Inspector `ui`: UI routes\n\n- Runtime: `nodejs`\n- Directory: `.`\n- Command: `node` `tools/inspect-ui.mjs`\
+\n- Timeout seconds: `30`\n- Max output bytes: `1048576`\n- Entry files: `src/main.js`\n"}),i({name:"architecture-layout",
+title:"Architecture layout",section:"Architecture layout",contract:"vibe64.architecture-layout.v1",summary:"Presentation\
+ groups for the Architecture view. Declarations neither discover subsystems nor change their ownership.",body:`
+Headings: \`\` ### Group \`id\`: Title \`\`, each followed by:
+    - Kind: ${O.map(e=>`\`${e}\``).join(" or ")}
+    - Purpose: \`text\`
+    - Subsystem: \`root\` (one or more)
+
+- Every group needs Kind, Purpose and at least one Subsystem. Group ids are unique.
+- A Subsystem is a directory root from \`genesis/subsystems.md\`; each root is placed once. A missing root is reported, ne\
+ver invented.
+`,example:"\n### Group `shared`: Shared libraries\n\n- Kind: `libraries`\n- Purpose: `Code reused by every surface.`\n- Subsy\
+stem: `packages/shared`\n"})]);export{qe as VIBE64_GENESIS_AGENT_SPECS};