Validate packed scaffold release

[localhost41]

Release validation tracker for @localhostlabs/create-qvac-app.

Required before production-facing alpha release:

• Build from a clean checkout and run pnpm install --frozen-lockfile, pnpm lint, pnpm test, and pnpm build.
• Run npm pack and validate the packed tarball, not the working tree.
• From a temporary directory, run the packed CLI help command.
• Scaffold smoke-qvac-chat --template node-chat from the packed artifact.
• In the generated app, run install/build smoke checks.
• With a live QVAC endpoint, run the generated app and confirm it prints a chat completion.

Record exact commands, tarball name, package version, Node/pnpm versions, OS, QVAC endpoint shape, QVAC version or commit, model, pass/fail outcome, and sanitized logs.

Factory checklist: /Users/samaroomini/qvac-factory/docs/production-readiness-release-plan.md.

[localhost41]

Release validation run completed from merged main after PR #23.

Environment:

• Repo checkout: /tmp/create-qvac-app-validation.BfR66P/checkout
• Commit: 534600dc66556817cf5705d7b3596d88811ff6b4
• Package: @localhostlabs/create-qvac-app@0.1.0-alpha.1
• Tarball: localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz
• Node: v26.3.0
• npm: 11.16.0
• pnpm: 11.10.0
• OS: Darwin samaroomini.local 25.2.0 ... RELEASE_ARM64_T8132 arm64
• QVAC endpoint checked: GET http://127.0.0.1:11434/v1/models
• Model: qvac-local
• QVAC version/commit: not exposed by GET /version or GET /v1/version (both returned 404)

Commands run:

git clone /Users/samaroomini/qvac-factory/repos/create-qvac-app /tmp/create-qvac-app-validation.BfR66P/checkout
cd /tmp/create-qvac-app-validation.BfR66P/checkout
git checkout main
git rev-parse HEAD
node --version
npm --version
pnpm --version
uname -a
pnpm install --frozen-lockfile
pnpm lint
pnpm test
pnpm build
pnpm verify
npm pack --pack-destination /tmp/create-qvac-app-validation.BfR66P
tar -tzf /tmp/create-qvac-app-validation.BfR66P/localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz | sort
mkdir -p /tmp/create-qvac-app-validation.BfR66P/help-check
cd /tmp/create-qvac-app-validation.BfR66P/help-check
npm init -y
npm install /tmp/create-qvac-app-validation.BfR66P/localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz
npx create-qvac-app --help
mkdir -p /tmp/create-qvac-app-validation.BfR66P/scaffold
cd /tmp/create-qvac-app-validation.BfR66P/scaffold
npm exec --package /tmp/create-qvac-app-validation.BfR66P/localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz -- create-qvac-app smoke-qvac-chat --template node-chat
cd smoke-qvac-chat
find . -maxdepth 3 -type f | sort
pnpm install
pnpm build
curl -sS http://127.0.0.1:11434/v1/models
QVAC_BASE_URL=http://127.0.0.1:11434/v1 pnpm dev
QVAC_BASE_URL=http://127.0.0.1:11434 pnpm dev

Results:

• pnpm install --frozen-lockfile: PASS
• pnpm lint: PASS
• pnpm test: PASS, 2 files / 6 tests passed
• pnpm build: PASS
• pnpm verify: PASS, including test/pack.test.ts
• npm pack: PASS
• Tarball contents: PASS, contains only CHANGELOG.md, LICENSE, README.md, dist/cli.d.ts, dist/cli.js, dist/index.d.ts, dist/index.js, package.json
• Temp install from packed tarball: PASS
• Packed CLI help: PASS
• Scaffold smoke-qvac-chat --template node-chat from packed artifact: PASS
• Generated app pnpm install: PASS
• Generated app pnpm build: PASS
• Live QVAC run with requested OpenAI-style base URL QVAC_BASE_URL=http://127.0.0.1:11434/v1: FAIL, generated app requested /v1/v1/chat/completions effectively and received QVAC request failed: 404 Not Found
• Live QVAC run with template's expected origin-style value QVAC_BASE_URL=http://127.0.0.1:11434: PASS, printed a chat completion from qvac-local

Sanitized log excerpts:

pnpm install --frozen-lockfile
Done in 327ms using pnpm v11.10.0

pnpm test
Test Files  2 passed (2)
Tests       6 passed (6)

pnpm verify
Test Files  2 passed (2)
Tests       6 passed (6)
Test Files  1 passed (1)
Tests       1 passed (1)

npm pack
filename: localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz
package size: 4.9 kB
unpacked size: 12.4 kB
total files: 8

npx create-qvac-app --help
create-qvac-app
Usage:
  create-qvac-app <project-directory> [options]
Options:
  --template node-chat  Scaffold a Node TypeScript QVAC chat app without prompting
  -h, --help            Show help text

scaffold
Created QVAC node-chat app in /private/tmp/create-qvac-app-validation.BfR66P/scaffold/smoke-qvac-chat
./README.md
./package.json
./src/index.ts
./tsconfig.json

curl /v1/models
{"object":"list","data":[{"id":"qvac-local","object":"model","created":1783641487,"owned_by":"qvac"}]}

QVAC_BASE_URL=http://127.0.0.1:11434/v1 pnpm dev
QVAC request failed: 404 Not Found
REQUESTED_BASE_STATUS=1

QVAC_BASE_URL=http://127.0.0.1:11434 pnpm dev
[chat completion text printed]
ORIGIN_BASE_STATUS=0

Recommendation: the packed scaffold is otherwise release-valid, but I would not close this issue if the intended QVAC_BASE_URL contract is an OpenAI-style base URL ending in /v1. It can close if the intended contract is origin-style (http://host:port) and the README/template wording is considered acceptable as-is.

[localhost41]

Follow-up live validation passed after PR #24.

Fixed main:

• Commit: 4e1d2c8337515b98202afad22f1a8ab5b9a00a2f
• PR: Normalize generated QVAC base URLs #24, Normalize generated QVAC base URLs
• Package: @localhostlabs/create-qvac-app@0.1.0-alpha.1
• Tarball: localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz
• Node: v26.3.0
• npm: 11.16.0
• pnpm: 11.10.0
• Model: qvac-local
• Required base URL: QVAC_BASE_URL=http://127.0.0.1:11434/v1

Commands run from a fresh packed artifact:

VALIDATION_ROOT="$(mktemp -d /tmp/create-qvac-app-livefix.XXXXXX)"
git clone /Users/samaroomini/qvac-factory/repos/create-qvac-app "$VALIDATION_ROOT/checkout"
cd "$VALIDATION_ROOT/checkout"
git checkout main
git rev-parse HEAD
node --version
npm --version
pnpm --version
npm pack --pack-destination "$VALIDATION_ROOT"
ls -l "$VALIDATION_ROOT/localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz"
tar -tzf "$VALIDATION_ROOT/localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz" | sort
mkdir -p "$VALIDATION_ROOT/scaffold"
cd "$VALIDATION_ROOT/scaffold"
npm exec --yes --package "$VALIDATION_ROOT/localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz" -- create-qvac-app smoke-qvac-chat --template node-chat
cd smoke-qvac-chat
find . -maxdepth 3 -type f | sort
pnpm install
pnpm build
curl -sS http://127.0.0.1:11434/v1/models
QVAC_BASE_URL=http://127.0.0.1:11434/v1 QVAC_MODEL=qvac-local pnpm dev

Sanitized output:

COMMIT=4e1d2c8337515b98202afad22f1a8ab5b9a00a2f
VERSION=0.1.0-alpha.1
TARBALL=localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz
v26.3.0
11.16.0
11.10.0

npm pack
filename: localhostlabs-create-qvac-app-0.1.0-alpha.1.tgz
package size: 5.0 kB
unpacked size: 12.9 kB
shasum: e236119ce8e8810db6fcbde15676b5630335a264
total files: 8

packed contents
package/CHANGELOG.md
package/LICENSE
package/README.md
package/dist/cli.d.ts
package/dist/cli.js
package/dist/index.d.ts
package/dist/index.js
package/package.json

scaffold
Created QVAC node-chat app in /private/tmp/create-qvac-app-livefix.xdL2KX/scaffold/smoke-qvac-chat
./README.md
./package.json
./src/index.ts
./tsconfig.json

generated app install/build
Done in 313ms using pnpm v11.10.0
$ tsc -p tsconfig.json

models
{"object":"list","data":[{"id":"qvac-local","object":"model","created":1783641487,"owned_by":"qvac"}]}

QVAC_BASE_URL=http://127.0.0.1:11434/v1 QVAC_MODEL=qvac-local pnpm dev
$ pnpm build && pnpm start
$ tsc -p tsconfig.json
$ node dist/index.js
[chat completion text printed]

Result: PASS. The previously failing OpenAI-style /v1 base URL now works from the packed artifact. Combined with the prior clean checkout/package/tarball/help/scaffold/install/build validation, all issue #22 validation requirements are satisfied. This issue can close.

[localhost41]

Closing after PR #24 follow-up validation passed from the fixed packed artifact with QVAC_BASE_URL=http://127.0.0.1:11434/v1 and model qvac-local.