chore: prepare 1.0.0 release

- License: BSL 1.1 (converts to MIT after 4 years)
- Version: 0.8.1 → 1.0.0
- Tarball: 2.1MB → 735KB (clean dist, no source maps)
- CI/CD: Node 20+22 matrix, fixed deprecated actions, concurrency groups
- TypeScript: reduced as-any casts 71% (153 → 44)
- CLI: Node 20+ runtime version check
- Docs: CHANGELOG 1.0.0, SECURITY.md, CONTRIBUTING.md
- Tests: 652 passing, lint clean, build 88ms

Author: StackMemory Bot (CLI)

.github/workflows/coverage-only.yml

@@ -3,6 +3,10 @@ name: Coverage Only
 on:
   workflow_dispatch:
 
+concurrency:
+  group: coverage-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   coverage:
     runs-on: ubuntu-latest
@@ -36,3 +40,9 @@ jobs:
           fail_ci_if_error: false
           verbose: true
 
+      - name: Upload coverage artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage/
+

.github/workflows/npm-publish.yml

@@ -11,45 +11,49 @@ on:
         required: true
         type: string
 
+concurrency:
+  group: publish-${{ github.ref }}
+  cancel-in-progress: false
+
 jobs:
   publish:
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     steps:
       - uses: actions/checkout@v4
-      
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: '20'
           registry-url: 'https://registry.npmjs.org'
-      
+          cache: 'npm'
+
       - name: Install dependencies
         run: npm ci
-      
+
       - name: Build
         run: npm run build
-      
+
       - name: Verify dist artifacts
         run: npm run verify:dist
-      
-      - name: Run tests
-        run: npm test
-      
+
+      - name: Run pre-publish tests
+        run: npm run test:pre-publish
+        env:
+          CI: true
+
       - name: Publish to NPM
         run: npm publish --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      
+
       - name: Create GitHub Release
         if: startsWith(github.ref, 'refs/tags/')
-        uses: actions/create-release@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        uses: softprops/action-gh-release@v2
         with:
-          tag_name: ${{ github.ref }}
-          release_name: Release ${{ github.ref }}
+          generate_release_notes: true
           body: |
             ## What's Changed
-            - Check [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md) for details
-          draft: false
-          prerelease: false
+            See [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md) for details.

.github/workflows/test-shared-context.yml

@@ -1,50 +1,62 @@
-name: Test Shared Context
+name: CI
 
 on:
   push:
+    branches: [main]
     paths:
-      - 'src/core/context/**'
-      - 'src/core/session/**'
-      - 'src/cli/**'
+      - 'src/**'
+      - 'scripts/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - 'tsconfig*.json'
+      - 'esbuild.config.js'
+      - 'vitest.config.ts'
       - '.github/workflows/test-shared-context.yml'
   pull_request:
+    branches: [main]
     paths:
-      - 'src/core/context/**'
-      - 'src/core/session/**'
-      - 'src/cli/**'
+      - 'src/**'
+      - 'scripts/**'
+      - 'package.json'
+      - 'package-lock.json'
+      - 'tsconfig*.json'
+      - 'esbuild.config.js'
+      - 'vitest.config.ts'
   workflow_dispatch:
 
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   test:
     runs-on: ubuntu-latest
-    
+
     strategy:
       matrix:
-        node-version: [18.x, 20.x]
-    
+        node-version: [20.x, 22.x]
+
     steps:
     - uses: actions/checkout@v4
-    
+
     - name: Use Node.js ${{ matrix.node-version }}
       uses: actions/setup-node@v4
       with:
         node-version: ${{ matrix.node-version }}
         cache: 'npm'
-    
+
     - name: Install dependencies
       run: npm ci
-    
+
     - name: Build project
       run: npm run build
-    
+
     - name: Verify dist artifacts
       run: npm run verify:dist
-    
-    - name: Run shared context tests
-      run: npm run test:shared-context
-      env:
-        CI: true
-    
+
+    - name: Run lint
+      run: npm run lint
+
     - name: Run all tests
       run: npm run test:run
       env:
@@ -65,7 +77,7 @@ jobs:
         flags: unit
         fail_ci_if_error: false
         verbose: true
-    
+
     - name: Upload test results
       if: always()
       uses: actions/upload-artifact@v4
@@ -78,49 +90,49 @@ jobs:
   integration:
     runs-on: ubuntu-latest
     needs: test
-    
+
     steps:
     - uses: actions/checkout@v4
-    
+
     - name: Setup Node.js
       uses: actions/setup-node@v4
       with:
         node-version: 20.x
         cache: 'npm'
-    
+
     - name: Install dependencies
       run: npm ci
-    
+
     - name: Build project
       run: npm run build
-    
+
     - name: Verify dist artifacts
       run: npm run verify:dist
-    
+
     - name: Test CLI integration
       run: |
         # Initialize test project
         mkdir -p /tmp/test-project
         cd /tmp/test-project
         npx stackmemory init
-        
-        # Test status command with shared context
+
+        # Test status command
         npx stackmemory status
-        
+
         # Create test frames and sync
         echo "Testing shared context..." | npx stackmemory context push "Test Frame" --type task
         npx stackmemory context add decision "Use shared context for cross-session reference"
-        
+
         # Verify context persistence
         npx stackmemory status --project
-    
+
     - name: Verify shared context files
       run: |
         # Check if shared context directory exists
         if [ -d "$HOME/.stackmemory/shared-context" ]; then
-          echo "✅ Shared context directory exists"
+          echo "Shared context directory exists"
           ls -la "$HOME/.stackmemory/shared-context/"
         else
-          echo "❌ Shared context directory not found"
+          echo "Shared context directory not found"
           exit 1
         fi

.npmignore

@@ -1,3 +1,7 @@
+# Source maps (not needed in published CLI package)
+**/*.js.map
+**/*.d.ts.map
+
 # Source files (only ship dist)
 src/
 tsconfig.json

CHANGELOG.md

@@ -5,6 +5,46 @@ All notable changes to StackMemory will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0] - 2026-02-10
+
+### Highlights
+- First stable release of StackMemory
+- Licensed under BSL 1.1 (converts to MIT after 4 years)
+- 652 tests passing, TypeScript strict mode, Node 20+ required
+
+### Added
+- FTS5 full-text search with BM25 ranking and hybrid scoring
+- sqlite-vec embedding support with multi-provider architecture (Xenova, OpenAI)
+- Memory monitor daemon with auto-capture/clear cycle
+- Prompt Forge (GEPA) with AGENT.md watcher and extensions system
+- Skills system: spec generator, Linear task runner, agent prompt consolidation
+- DiffMem integration for long-term user memory
+- Retrieval signals, garbage collection, cold storage, multi-repo support
+- Node.js 20+ runtime version check at CLI startup
+- Claude Code hooks: auto-init on wrapper launch
+
+### Changed
+- Removed SMS/WhatsApp/Twilio integration (replaced with terminal bell notification)
+- Removed ngrok dependency
+- Reduced `as any` casts by 71% (153 to 44) with proper TypeScript interfaces
+- Consolidated test suite from 719 to 652 focused tests
+- CI/CD: Node 20+22 matrix, fixed deprecated actions, added concurrency groups
+- Build: clean dist before build, removed source maps from tarball (2.1MB to 735KB)
+- License changed from MIT to BSL 1.1
+
+### Fixed
+- Schema unification between FrameDatabase and SQLiteAdapter
+- FTS5 empty query fallback to LIKE search
+- Pre-publish script git dirty check race condition
+- Embedding provider initPromise reset on failure
+- SQLite pragma conflict in skills CLI
+- CLI test timeout flakes via module import caching
+
+### Security
+- Feature flags cleanup (removed stale whatsapp flag)
+- Removed dead feature stubs and scripts
+- Input validation improvements across CLI commands
+
 ## [0.3.15] - 2025-01-14
 
 ### Added

CONTRIBUTING.md

@@ -0,0 +1,63 @@
+# Contributing to StackMemory
+
+Thanks for your interest in contributing to StackMemory!
+
+## Getting Started
+
+```bash
+git clone https://github.com/stackmemoryai/stackmemory.git
+cd stackmemory
+npm install
+npm run build
+npm run test:run
+```
+
+## Development Workflow
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/your-feature`
+3. Make your changes
+4. Run validation: `npm run lint && npm run test:run && npm run build`
+5. Commit with conventional format: `type(scope): message`
+6. Open a pull request against `main`
+
+## Commit Messages
+
+Follow conventional commits:
+- `feat(scope):` new feature
+- `fix(scope):` bug fix
+- `refactor(scope):` code restructuring
+- `test(scope):` adding or updating tests
+- `chore(scope):` maintenance tasks
+- `docs(scope):` documentation changes
+
+## Code Standards
+
+- TypeScript strict mode is enabled
+- ESM modules with `.js` extensions on relative imports
+- Run `npm run lint` before committing (pre-commit hooks enforce this)
+- New features require tests in `src/**/__tests__/`
+- Maintain or improve test coverage
+
+## Project Structure
+
+```
+src/
+  cli/           # CLI commands and entry point
+  core/          # Core business logic (context, database, query)
+  integrations/  # External integrations (Linear, MCP)
+  services/      # Business services
+  utils/         # Shared utilities
+```
+
+## Testing
+
+```bash
+npm run test:run          # Run all tests once
+npm test                  # Watch mode
+npm run test:pre-publish  # Full pre-publish validation
+```
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the project's [BSL 1.1 license](./LICENSE).