{"id":"@lssm-tech/app.registry-server","slug":"app.registry-server","name":"@lssm-tech/app.registry-server","version":"5.0.4","path":"packages/apps/registry-server","manifestPath":"packages/apps/registry-server/package.json","manifestBlobSha":"ac488d90c0cad1c2cb1d2f3595f73cdb6e14b004","layer":"apps","physicalArea":null,"primaryArea":"tooling-and-agent-delivery","classification":{"privateDeclared":null,"catalogFamily":"runtime","catalogKind":"app","catalogStatus":"active","adoptionMode":"operator-only","stability":"stable"},"description":"Registry server for ContractSpec packages, contracts, and ecosystem metadata.","descriptionOrigin":"package.json","catalog":{"family":"runtime","kind":"app","status":"active","adoptionMode":"operator-only","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":["."],"documentation":[{"title":"App Registry Server documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fapp.registry-server","kind":"readme"}],"examples":[],"replacements":[],"nonAdoptableRationale":"This app is published for execution by operators, not as a reusable library dependency."},"canonicalImports":[],"scripts":{"publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","clean":"rm -rf dist server","lint":"bun run lint:fix","lint:fix":"node ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .","lint:check":"node ../../../scripts/biome.cjs check .","dev":"bun run --watch src/server.ts","build":"bun build --compile --minify-whitespace --minify-syntax --target bun --outfile dist/server src/index.ts","start":"./server"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.contracts-spec":"workspace:^","@elysiajs/cors":"^1.4.2","@elysiajs/server-timing":"^1.4.1","@lssm-tech/lib.logger":"workspace:^","elysia":"catalog:server"},"devDependencies":{"@lssm-tech/tool.typescript":"workspace:*"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts"},"publishExports":null,"types":null,"files":["src","README.md","LICENSE","!**/*.test.*","!**/*.spec.*"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/app.registry-server","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/apps/registry-server/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/registry-server/src/index.ts","sourceStatus":"verified source file"}]}],"entryCount":1,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"App Registry Server documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fapp.registry-server","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/registry-server","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/registry-server/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/registry-server/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/app.registry-server.txt"},"readme":{"status":"available","body":"# @lssm-tech/app.registry-server\n\nWebsite: https://contractspec.io\n\n**ContractSpec registry server. Serves contract specs and metadata over HTTP for IDE plugins, CLI tools, and other consumers.**\n\n## What It Does\n\n- Built with Elysia (Bun HTTP framework).\n- Uses `@lssm-tech/lib.contracts-spec` for contract definitions.\n- Uses `@lssm-tech/lib.logger` for structured logging.\n- Separate handlers for ContractSpec and LSSM routes.\n- `src/handlers/` contains handlers or demo adapters wired to contract surfaces.\n- `src/handlers/` contains handlers or demo adapters wired to contract surfaces.\n\n## Running Locally\n\nFrom `packages/apps/registry-server`:\n- `bun run dev`\n- `bun run start`\n- `bun run build`\n\n## Usage\n\n```bash\nbun run dev\n```\n\n## Architecture\n\n- Built with Elysia (Bun HTTP framework).\n- Uses `@lssm-tech/lib.contracts-spec` for contract definitions.\n- Uses `@lssm-tech/lib.logger` for structured logging.\n- Separate handlers for ContractSpec and LSSM routes.\n- `src/index.ts` is the root public barrel and package entrypoint.\n- `src/server.ts` is the main server bootstrap entrypoint.\n\n## Public Entry Points\n\n- This package is a deployable application rather than a library with published subpath exports.\n- Registry packages include the portable `src/` entrypoints for Bun. Host-native\n  `dist/server` executables and `.bun-build` scratch files are local build artifacts\n  and are not included in npm or GitHub Packages tarballs.\n\n## Local Commands\n\n- `bun run dev` — bun run --watch src/server.ts\n- `bun run start` — ./server\n- `bun run build` — bun build --compile --minify-whitespace --minify-syntax --target bun --outfile dist/server src/index.ts\n- `bun run lint` — bun run lint:fix\n- `bun run lint:check` — biome check .\n- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .\n- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose\n- `bun run publish:pkg:canary` — bun publish:pkg --tag canary\n- `bun run clean` — rm -rf dist server\n\n## Recent Updates\n\n- Replace eslint+prettier by biomejs to optimize speed.\n\n## Notes\n\n- API routes are consumed by IDE plugins and CI — do not change paths or response shapes without versioning.\n- Filesystem access must use the `src/utils/` helpers for consistent path resolution.\n","sourcePath":"packages/apps/registry-server/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/registry-server/README.md","blobSha":"4625619f81f6bdf7c7b3b1496f6c1bb6e150f36a","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"tooling-and-agent-delivery","areaTitle":"CLI, authoring and agent tooling","displayName":"app.registry-server","runtimes":["node"],"platforms":["server"],"kind":"app","scope":"Package manifest","canonicalRoute":"/docs/packages/app.registry-server/","contextUrl":"/docs/packages/app.registry-server.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}