chore: bump version to 0.2.2

Fix critical workspace:* dependency issue and update changelog

- Remove @leanspec/core from dependencies (bundled by tsup)
- Add @leanspec/core to devDependencies for build
- Mark tiktoken as external to avoid dynamic require issues
- Add tiktoken to CLI dependencies
- Update CHANGELOG with recent work:
  - Template engine for AGENTS.md (spec 073)
  - Intelligent search engine (spec 075)
  - Programmatic spec management (spec 059, Phase 1-2)
  - Programmatic spec relationships (spec 076)
  - Sub-spec template system (spec 078)
  - Archiving strategy (spec 077)
- Update AGENTS.md publishing instructions with workspace:* checks

Author: tikazyq

AGENTS.md

@@ -225,10 +225,20 @@ When working on the LeanSpec codebase itself, always use the local build (`node
 2. **Update CHANGELOG.md**: Add release notes with date and version
 3. **Build**: Run `pnpm build` to build all packages
 4. **Test**: Run `pnpm test:run` to ensure tests pass (web DB tests may fail - that's OK)
-5. **Commit**: `git add -A && git commit -m "chore: bump version to X.Y.Z"`
-6. **Publish**: `cd packages/cli && npm publish` (only publish the CLI package)
-7. **Tag**: `git tag vX.Y.Z && git push origin main --tags`
-8. **Verify**: `npm view lean-spec version` to confirm publication
+5. **Validate**: Run `node bin/lean-spec.js validate` and `cd docs-site && npm run build` to ensure everything works
+6. **Commit**: `git add -A && git commit -m "chore: bump version to X.Y.Z"`
+7. **Publish**: `cd packages/cli && npm publish` (only publish the CLI package)
+8. **Tag**: `git tag vX.Y.Z && git push origin main --tags`
+9. **Verify**: 
+   - `npm view lean-spec version` to confirm publication
+   - `npm view lean-spec dependencies` to ensure no `workspace:*` dependencies leaked
+   - Test installation: `npm install -g lean-spec@latest` in a clean environment
+
+**Critical - Workspace Dependencies:**
+- The `@leanspec/core` package MUST NOT be in `packages/cli/package.json` dependencies
+- tsup config has `noExternal: ['@leanspec/core']` which bundles the core package
+- NEVER add `@leanspec/core` back to dependencies - it will cause `workspace:*` errors
+- If you see `workspace:*` in published dependencies, the package is broken and must be republished
 
 **Important**: Do NOT publish `@leanspec/core` or `@leanspec/web` - they are internal packages. The `@leanspec` npm scope doesn't exist, and the core package is bundled into the CLI distribution.
 

CHANGELOG.md

@@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2025-11-13
+
+### Added
+- **Template Engine for AGENTS.md** (spec 073) - Dynamic template system for maintaining AGENTS.md with mechanical transformations
+- **Intelligent Search Engine** (spec 075) - Relevance-ranked search with TF-IDF scoring and content-based ranking
+- **Programmatic Spec Management** (spec 059, Phase 1-2) - `analyze`, `split`, `compact` commands for automated spec restructuring
+- **Programmatic Spec Relationships** (spec 076) - CLI and MCP tools for managing `depends_on` and `related` fields
+- **Sub-spec Template System** (spec 078) - Documentation for creating and managing multi-file spec structures
+- **Archiving Strategy** (spec 077) - Documentation for proper spec archival workflows
+
+### Changed
+- Search commands now use intelligent ranking algorithm prioritizing title/frontmatter matches
+- MCP search tool upgraded with relevance scoring and better result filtering
+- AGENTS.md validation enforces template system consistency
+
+### Fixed
+- **Critical npm publishing bug**: `workspace:*` dependency in published package causing installation failures
+  - Root cause: pnpm workspace protocol leaked into published tarball
+  - Fix required: Use pnpm's `--no-workspace` flag or proper bundling configuration
+
+### In Progress
+- Spec 059 (Programmatic Management) - Phases 1-2 complete, remaining phases in progress
+- Spec 072 (AI Agent First-Use Workflow) - Planning stage
+- Spec 074 (Content at Creation) - Specification stage
+
 ## [0.2.1] - 2025-11-13
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "lean-spec-monorepo",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": true,
   "type": "module",
   "description": "Lightweight spec methodology for AI-powered development (monorepo root)",

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lean-spec",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Lightweight spec methodology for AI-powered development",
   "type": "module",
   "bin": {
@@ -41,7 +41,6 @@
   ],
   "dependencies": {
     "@inquirer/prompts": "^7.9.0",
-    "@leanspec/core": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.21.0",
     "chalk": "^5.3.0",
     "cli-spinners": "^3.3.0",
@@ -63,10 +62,12 @@
     "ora": "^9.0.0",
     "react": "^19.2.0",
     "strip-ansi": "^7.1.2",
+    "tiktoken": "^1.0.22",
     "tokenx": "^1.2.1",
     "zod": "^3.25.76"
   },
   "devDependencies": {
+    "@leanspec/core": "workspace:*",
     "@types/handlebars": "^4.1.0",
     "@types/js-yaml": "^4.0.9",
     "@types/marked-terminal": "^6.1.1",

packages/cli/tsup.config.ts

@@ -7,5 +7,8 @@ export default defineConfig({
   clean: true,
   sourcemap: true,
   treeshake: true,
-  external: ['@leanspec/core'],
+  // Bundle @leanspec/core into the distribution
+  noExternal: ['@leanspec/core'],
+  // Don't bundle tiktoken - it has native dependencies and dynamic requires
+  external: ['tiktoken'],
 });

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanspec/core",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Core spec parsing and validation library for LeanSpec",
   "type": "module",
   "main": "./dist/index.js",

packages/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanspec/web",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "LeanSpec Web: Fullstack spec showcase platform",
   "private": true,
   "type": "module",