{"_id":"@brnbco/specmill","name":"@brnbco/specmill","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.2":{"name":"@brnbco/specmill","version":"0.1.2","description":"Industrial-strength CLI that expands a requirements.md file into full .cursor spec docs with Azure OpenAI (o3-mini)","type":"module","bin":{"specmill":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"ts-node src/index.ts"},"keywords":["cli","openai","azure","markdown","generator"],"dependencies":{"chalk":"^5.3.0","commander":"^12.0.0","ora":"^8.0.1","dotenv":"^16.4.0"},"devDependencies":{"@types/node":"^20.11.0","ts-node":"^10.9.2","typescript":"^5.5.0"},"engines":{"node":">=20.19.0"},"_id":"@brnbco/specmill@0.1.2","gitHead":"1737e182de4e81bfeaf5cc8e71b76150c4cd9b27","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-I3K1s+sHNi7l055HmL86waSCbJLLn0F4ecneOUkcEZMrq5sAUYmtmD11adRhMh1QsWqDQu2ftmvoqGXrix9nfA==","shasum":"f0a0d40a27911c96997e29f2982049dcbfa168c7","tarball":"https://registry.npmjs.org/@brnbco/specmill/-/specmill-0.1.2.tgz","fileCount":8,"unpackedSize":70978,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDhRDM7lp7B4e6YF4X0afRbu+AeFG6Xf59uu+BMygC6yAIgZYrMeQIPzDCdIfc8e5QIK3+6rxQ8q863AUD8vt86SKs="}]},"_npmUser":{"name":"brnbco","email":"braun@brand.co"},"directories":{},"maintainers":[{"name":"brnbco","email":"braun@brand.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/specmill_0.1.2_1746026861913_0.3880598424229964"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-30T15:27:41.802Z","0.1.2":"2025-04-30T15:27:42.081Z","modified":"2025-04-30T15:27:42.368Z"},"maintainers":[{"name":"brnbco","email":"braun@brand.co"}],"description":"Industrial-strength CLI that expands a requirements.md file into full .cursor spec docs with Azure OpenAI (o3-mini)","keywords":["cli","openai","azure","markdown","generator"],"readme":"<img src=\"specmill-logo.png\" />\n\n# @brnbco/specmill <!-- NPM Version: Will activate upon publish --> ![NPM Version](https://img.shields.io/npm/v/@brnbco/specmill) <!-- Node Version: From package.json engines --> ![Node Version](https://img.shields.io/badge/Node.js-%3E%3D20.19.0-blue) ![Language](https://img.shields.io/github/languages/top/brnbco/specmill) <!-- License: Assumed MIT, NPM badge will activate upon publish --> ![License](https://img.shields.io/badge/License-MIT-yellow)\n\nIndustrial-strength CLI that expands a `requirements.md` file into full `.cursor` spec docs with Azure OpenAI (o3-mini).\n\n## Overview\n\n`specmill` takes a requirements file (typically Markdown) and uses Azure OpenAI's language models to automatically generate a comprehensive set of specification documents commonly used in software development workflows, particularly those involving AI pair programmers like Cursor.\n\nIt generates files such as:\n\n*   `.cursor/PRD.md`\n*   `.cursor/USER_STORIES.md`\n*   `.cursor/TECH_STORIES.md`\n*   `.cursor/ARCHITECTURE.md` (with Mermaid diagrams)\n*   `.cursor/TECH_STACK.md`\n*   `.cursor/INFRASTRUCTURE.md` (with Mermaid diagrams)\n*   `.cursor/IMPLEMENTATION_PLAN.md`\n*   `.cursor/FILE_STRUCTURE.md`\n*   `.cursor/RULES.md`\n\n## Installation\n\n```bash\nnpm install -g @brnbco/specmill\n# or\nyarn global add @brnbco/specmill\n```\n\nAlternatively, you can use it directly without global installation:\n\n```bash\nnpx @brnbco/specmill [options] [requirements_file]\n```\n\n## Usage\n\n```bash\nspecmill [options] [requirements_file]\n```\n\n**Arguments:**\n\n*   `requirements_file`: Path to the input requirements file (defaults to `requirements.md`).\n\n**Options:**\n\n*   `-o, --outdir <dir>`: Output directory for generated spec files (defaults to `.cursor`).\n*   `-m, --model <deployment>`: Azure OpenAI deployment name (defaults to `o3-mini` or `AZURE_OPENAI_DEPLOYMENT` env var).\n*   `-v, --api-version <ver>`: Azure OpenAI API version (defaults to `2024-02-15-preview`).\n*   `-h, --help`: Display help for command.\n\n**Environment Variables:**\n\n*   `AZURE_OPENAI_ENDPOINT`: Your Azure OpenAI endpoint URL (required).\n*   `AZURE_OPENAI_API_KEY`: Your Azure OpenAI API key (required).\n*   `AZURE_OPENAI_DEPLOYMENT`: Default model deployment name (optional, overrides `-m` default).\n\nYou can place these variables in a `.env` file in the directory where you run `specmill`.\n\n**Example:**\n\n```bash\n# Generate specs from my_app_requirements.md into the ./specs directory\nspecmill -o ./specs my_app_requirements.md\n```\n\n## Development\n\n1.  Clone the repository.\n2.  Install dependencies: `npm install`\n3.  Build the project: `npm run build`\n4.  Run in development mode: `npm run dev -- [options] [requirements_file]`\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request.\n\n## License\n\nThis project is licensed under the MIT License. <!-- The NPM license badge (shields.io/npm/l/) will reflect the license specified in package.json upon publishing --> ","readmeFilename":"README.md","_rev":"1-05ccb3fce02bc7401d9a40573db12e6d"}