{"_id":"@bridgerosepetal/starfront-cli","_rev":"2-933bb0261660b4d393e3a7d1802e695f","name":"@bridgerosepetal/starfront-cli","dist-tags":{"latest":"0.5.0"},"versions":{"0.4.0":{"name":"@bridgerosepetal/starfront-cli","version":"0.4.0","keywords":["cli","astro","starfront"],"author":{"name":"Nikolay Kulikov","email":"slashoptiontwo@gmail.com"},"license":"MIT","_id":"@bridgerosepetal/starfront-cli@0.4.0","maintainers":[{"name":"bridgerosepetal","email":"slashoptiontwo@gmail.com"}],"homepage":"https://github.com/bridgerosepetal/starfront-cli#readme","bugs":{"url":"https://github.com/bridgerosepetal/starfront-cli/issues"},"bin":{"starfront":"dist/index.js","starfront-cli":"dist/index.js"},"dist":{"shasum":"13244471c1138bb1da5b1439eac53f497ca22b8b","tarball":"https://registry.npmjs.org/@bridgerosepetal/starfront-cli/-/starfront-cli-0.4.0.tgz","fileCount":6,"integrity":"sha512-0kWYtwOnhPjzQNR+Qq4Ay1rcPfyoOme2F6QqjyS3PN/YCTsL2hZWMQ5scchkh1hdj3IiaT2i37/A/Acfa3wBjg==","signatures":[{"sig":"MEQCIGaaEQ8BKBmwbHMSKtSUbVKvseT6JBZenFE+DUst46QgAiAfswsWbR1jhoeNKrMCVacMkfZBuulz+qI3yqi6vHUIag==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":181391},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"3fdf1bfe2010126ee6a0e20f419dade6808b40e9","scripts":{"dev":"tsx src/index.ts","lint":"eslint .","test":"vitest run --passWithNoTests","build":"tsup","format":"prettier . --write","typecheck":"tsc --noEmit","pack:check":"npm pack --dry-run","format:check":"prettier . --check"},"_npmUser":{"name":"bridgerosepetal","email":"slashoptiontwo@gmail.com"},"repository":{"url":"git+https://github.com/bridgerosepetal/starfront-cli.git","type":"git"},"_npmVersion":"11.6.2","description":"CLI tooling for Starfront projects.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"parse5":"^8.0.1","recast":"^0.23.11","ts-morph":"^28.0.0","commander":"^14.0.3","typescript":"^6.0.3","magic-string":"^0.30.21","@astrojs/compiler":"^4.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.3","sass":"^1.94.2","tsup":"^8.5.1","eslint":"^10.4.0","vitest":"^4.0.13","@eslint/js":"^10.0.1","@types/node":"^25.9.1","typescript-eslint":"^8.59.4","@front-cmdt/format":"^1.4.5"},"_npmOperationalInternal":{"tmp":"tmp/starfront-cli_0.4.0_1779700696913_0.5965910098015152","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@bridgerosepetal/starfront-cli","version":"0.5.0","description":"CLI tooling for Starfront projects.","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"bin":{"starfront":"dist/index.js","starfront-cli":"dist/index.js","starfront-mcp":"dist/mcp.js"},"scripts":{"build":"tsup","dev":"tsx src/index.ts","format":"prettier . --write","format:check":"prettier . --check","lint":"eslint .","pack:check":"npm pack --dry-run","test":"vitest run --passWithNoTests","typecheck":"tsc --noEmit"},"keywords":["cli","astro","starfront"],"author":{"name":"Nikolay Kulikov","email":"slashoptiontwo@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/bridgerosepetal/starfront-cli.git"},"bugs":{"url":"https://github.com/bridgerosepetal/starfront-cli/issues"},"homepage":"https://github.com/bridgerosepetal/starfront-cli#readme","engines":{"node":">=20"},"publishConfig":{"access":"public"},"dependencies":{"@astrojs/compiler":"^4.0.0","@modelcontextprotocol/sdk":"^1.29.0","commander":"^14.0.3","magic-string":"^0.30.21","parse5":"^8.0.1","postcss":"^8.5.15","recast":"^0.23.11","sass-parser":"^0.4.45","ts-morph":"^28.0.0","typescript":"^6.0.3","zod":"^4.4.3"},"devDependencies":{"@eslint/js":"^10.0.1","@front-cmdt/format":"^1.4.5","@types/node":"^25.9.1","eslint":"^10.4.0","sass":"^1.94.2","tsup":"^8.5.1","tsx":"^4.22.3","typescript-eslint":"^8.59.4","vitest":"^4.0.13"},"gitHead":"4a3e97508e910494bdaf6fd71f97e4ed1dbb0cbd","_id":"@bridgerosepetal/starfront-cli@0.5.0","_nodeVersion":"24.16.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-JqwMLY/o4SSVmoMQLro+NlxqWbgvAMVIMMFe0VKLYC8/m6EW5Fd1GgAjdIw30xYYEQZ1EhGX2GvNxWHBcK94HA==","shasum":"c7ebd8d2b78ec1b2e22d1768298708261a8252e5","tarball":"https://registry.npmjs.org/@bridgerosepetal/starfront-cli/-/starfront-cli-0.5.0.tgz","fileCount":11,"unpackedSize":460285,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bridgerosepetal%2fstarfront-cli@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD3/NRgFtNome0T1M10Y9VDlJBBGmxyFxiGV0msZn24kgIgH7P5n9+TbUtg2iljKABSSceKLNWtB0yClXT9HcrHw7I="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:96898997-a70b-46c6-a43c-f7bb6b5f1b29"}},"directories":{},"maintainers":[{"name":"bridgerosepetal","email":"slashoptiontwo@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/starfront-cli_0.5.0_1780409306831_0.9263407053351105"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-25T09:18:16.775Z","modified":"2026-06-02T14:08:27.303Z","0.4.0":"2026-05-25T09:18:17.064Z","0.5.0":"2026-06-02T14:08:27.019Z"},"bugs":{"url":"https://github.com/bridgerosepetal/starfront-cli/issues"},"author":{"name":"Nikolay Kulikov","email":"slashoptiontwo@gmail.com"},"license":"MIT","homepage":"https://github.com/bridgerosepetal/starfront-cli#readme","keywords":["cli","astro","starfront"],"repository":{"type":"git","url":"git+https://github.com/bridgerosepetal/starfront-cli.git"},"description":"CLI tooling for Starfront projects.","maintainers":[{"name":"bridgerosepetal","email":"slashoptiontwo@gmail.com"}],"readme":"# Starfront CLI\n\nCLI tooling for Starfront projects.\n\n## Development\n\n```sh\nnpm install\nnpm run build\nnpm test\n```\n\n## Local install check\n\n```sh\nnpm pack --dry-run\nnpm install -g .\nstarfront --help\n```\n\n## MCP server\n\nStart the Starfront MCP server for a specific project:\n\n```sh\nstarfront mcp --project /path/to/project\n```\n\nThe package also exposes a direct stdio bin:\n\n```sh\nstarfront-mcp --project /path/to/project\n```\n\nMCP clients can switch the active project later with the `project_set_root` tool.\n\nThe MCP exposes structured UI component tools and low-level CLI replay tools:\n\n- `command_reference` returns the shared CLI/MCP vocabulary.\n- `ui_component_create`, `ui_component_update`, `ui_component_read`, `ui_component_validate`, `ui_component_list`, and `ui_component_delete` are the normal tools for UI component work.\n- Prefer dedicated edit tools over `ui_component_update`: `ui_component_prop_create`, `ui_component_root_append`, `ui_component_bem_block_style_declare`, `ui_component_bem_element_style_declare`, `ui_component_bem_modifier_classlist_add`, `ui_component_bem_modifier_style_declare`, `ui_component_root_classlist_add`, and `ui_component_root_delete`.\n- Creating a `variant` or `color` prop automatically adds the matching root BEM modifier expression to `class:list`.\n- BEM elements are child parts such as `button__text`; BEM variants/colors/states should usually be root modifiers such as `button_variant-contained`.\n- Variant value styles are nested SCSS. Use modifier `variant` with value `primary`, not modifier `variant-primary`; Starfront renders `&_variant { &-primary { ... } }`.\n- `command_run` is a debug/replay escape hatch for exact CLI commands such as `starfront ui component create button button`.\n- `command_history` returns timestamped CLI-equivalent commands for the current MCP session.\n\nEvery MCP command is also appended as JSONL to `.starfront/mcp.log` in the active project.\n\nThe command vocabulary is defined once in `starfrontCommandRegistry`. The CLI, MCP `command_run`, MCP\n`command_reference`, and library `runStarfrontCommand` all use that registry.\n\n## Library command vocabulary\n\nCode can use the same command vocabulary without spawning the CLI:\n\n```ts\nimport { runStarfrontCommand } from '@bridgerosepetal/starfront-cli'\n\nawait runStarfrontCommand({\n  cwd: '/path/to/project',\n  command: 'starfront ui component create button button',\n})\n```\n","readmeFilename":"README.md"}