@nivora/matrix 0.1.0 → 0.2.0

package/README.md

@@ -1,35 +1,78 @@
-# GAMP 5 V-Model Traceability System
+# Matrix - GAMP 5 Traceability System
 
-A streamlined requirements traceability and test management system designed for regulated environments, using **Gherkin as the source of truth** for Functional Specifications.
+A **spec-as-code** requirements traceability system for regulated environments. Write Gherkin specs, run them as tests, and maintain automatic audit-ready traceability.
 
-📚 **Documentation**:
-- [**User Guide**](./USER_GUIDE.md): How to use the dashboard and CLI.
-- [**Developer Guide**](./DEVELOPER_GUIDE.md): Architecture, setup, and development workflow.
-- [**Philosophy & Approach**](./GAMP_AND_V_MODEL.md): GAMP 5 principles, V-Model, and "Spec-as-Code" reasoning.
+## Quickstart
 
+```bash
+bun add @nivora/matrix
+bunx matrix init
+bunx matrix serve
+```
+
+Dashboard available at: http://localhost:3000
 
-## Data Model
+---
 
-This system uses a **relational model** with 3 artifact types and no duplicate data:
+## Core Concepts
 
-| Artifact | Format | Location | Purpose |
-|----------|--------|----------|---------|
-| **URS** | Database | SQLite Table `urs` | High-level business requirements |
-| **FS** | Gherkin | `specs/fs/*.requirement` | Functional specs + embedded test scenarios |
-| **RISK** | Database | SQLite Table `risks` | Risk assessments linked to FS |
+This system implements **GAMP 5** and **V-Model** compliance by making specifications executable:
 
-### Key Insight: Gherkin IS the Functional Specification
+| Artifact | Storage | Purpose |
+|----------|---------|---------|
+| **URS** | SQLite DB | High-level business requirements |
+| **FS** | Gherkin `.requirement` files | Functional specs + test scenarios |
+| **Risk** | SQLite DB | Risk assessments & mitigations |
+| **Release** | SQLite DB | Version management & test results |
 
-Instead of maintaining separate FS documents and test files, we use Gherkin Feature files AS the functional specification:
+**Key Insight**: The Gherkin Feature file IS the Functional Spec AND the test. No duplication.
 
 ```gherkin
 @URS-001 @RISK-001
-Feature: FS-001 User Login Authentication
-  The system shall provide a login interface that authenticates users 
-  against stored credentials and establishes a secure session.
+Feature: FS-001 User Login
+  The system shall authenticate users against stored credentials.
+  
+  Scenario: Successful login
+    Given I am on the login page
+    When I enter valid credentials
+    Then I should see my dashboard
+```
+
+---
+
+## Workflow
+
+### 1. Create User Requirements (URS)
+
+**Option A: Dashboard UI**
+1. Navigate to http://localhost:3000/specs
+2. Click "New Specification"
+3. Fill in Title, Business Need, Acceptance Criteria
+4. Save
+
+**Option B: Stub Generation (Recommended)**
+
+Reference URS IDs in your Gherkin files before they exist:
+
+```gherkin
+@URS-011
+Feature: FS-009 Password Reset
+```
+
+Run `matrix sync` and the system creates a placeholder `URS-011` record. Fill in details via the dashboard later.
+
+### 2. Write Functional Specs (FS)
+
+Create `.requirement` files in `specs/fs/`:
+
+```gherkin
+@URS-001 @URS-002 @RISK-005
+Feature: FS-001 User Authentication
+  The system shall authenticate users against stored credentials
+  and establish a secure session.
   
   Requirements:
-  - FR-001.1: Display login form with email and password fields
+  - FR-001.1: Display login form with email and password
   - FR-001.2: Validate credentials against stored hash
   - FR-001.3: Rate limit after 5 failed attempts
 
@@ -37,149 +80,192 @@ Feature: FS-001 User Login Authentication
     Given I am on the login page
     When I enter valid credentials
     Then I should be redirected to my dashboard
+
+  Scenario: Failed login locks account after 5 attempts
+    Given I have failed login 4 times
+    When I enter invalid credentials
+    Then I should see "Account locked"
 ```
 
-**Benefits:**
-- **No duplication**: The Feature description IS the spec, scenarios ARE the tests
-- **Single source of truth**: Edit one file, both spec and tests are updated
-- **Clear traceability**: `@URS-xxx` and `@RISK-xxx` tags create automatic links
-- **Executable specs**: The `.requirement` files can be run by Cucumber
+**Linking Tags:**
+- `@URS-xxx` — Links to User Requirement
+- `@RISK-xxx` — Links to Risk Assessment
 
-## Directory Structure
+### 3. Create Risk Assessments
 
-```
-docs/
-├── specs/
-│   └── fs/                     # Functional Specs (Gherkin)
-│       ├── FS-001-login.requirement
-│       ├── FS-002-session.requirement
-│       ├── FS-003-registration.requirement
-│       ├── FS-004-booking.requirement
-│       ├── FS-005-waitlist.requirement
-│       ├── FS-006-schedule.requirement
-│       └── FS-007-instructor.requirement
-└── src/                        # Next.js Dashboard
-```
+**Option A: Dashboard UI** — Same flow as URS
 
-## Linking Artifacts
+**Option B: Stub Generation** — Reference `@RISK-xxx` in Gherkin, run sync, fill in details later
 
-### URS to FS
-Use `@URS-xxx` tag in the Gherkin Feature:
-```gherkin
-@URS-001
-Feature: FS-001 User Login
+### 4. Sync to Database
+
+```bash
+matrix sync
 ```
 
-### FS to Risk
-Use `@RISK-xxx` tag in the Gherkin Feature:
-```gherkin
-@URS-001 @RISK-001
-Feature: FS-001 User Login
+**What sync does:**
+1. Parses all `.requirement` files in `specs/fs/`
+2. Updates database with Feature titles, descriptions, and scenarios
+3. Extracts `@URS` and `@RISK` tags
+4. Auto-creates stub records for any referenced IDs that don't exist
+
+> **Tip:** Write Gherkin first with new IDs, run sync, then fill in URS/Risk details via the dashboard.
+
+---
+
+## Release Management
+
+### 1. Create a Release
+
+```bash
+matrix release create -v 1.0.0 -n "MVP Launch" --notes "Initial release"
 ```
 
-### Verification Levels (V-Model)
-- **URS** → Verified by **PQ** (Performance Qualification)
-- **FS** → Verified by **OQ** (Operational Qualification)  
-- **Scenarios** → Verified by **IQ** (Installation Qualification)
+Creates a release with:
+- **Version**: Semantic version (e.g., 1.0.0)
+- **Name**: Human-readable name  
+- **Status**: Defaults to "planning"
+- **Notes**: Optional release notes
 
-## Running the Dashboard
+### 2. Tag Features to Release
 
 ```bash
-cd docs
-bun install
-bun run dev
+matrix release tag REL-001 --fs FS-001 FS-002 FS-003
 ```
 
-Access at: http://localhost:3000
+### 3. Run Tests
 
-## Dashboard Pages
+Execute Cucumber tests and export results:
 
-| Page | Description |
-|------|-------------|
-| `/` | Dashboard with stats, coverage, and traceability summary |
-| `/specs` | Browse URS (YAML), FS (Gherkin), and Risk (YAML) |
-| `/matrix` | Full traceability matrix: URS → FS → Scenarios → Risks |
-| `/builder` | Visual editor for creating new FS .requirement files |
-| `/search` | Search across all artifacts |
-
-## Creating New Artifacts
-
-### New URS (via Dashboard or manually)
-Create `specs/urs/URS-xxx.yaml`:
-```yaml
-id: URS-004
-type: urs
-title: New Business Requirement
-status: draft
-priority: high
-owner: Product Team
-category: Core
-business_need: |
-  Description of the business need...
-intended_use: |
-  How the system will be used...
-acceptance_criteria:
-  - Criterion 1
-  - Criterion 2
-regulatory_refs:
-  - GAMP 5
+```bash
+npx cucumber-js specs/fs/**/*.requirement --format json:results.json
 ```
 
-### New FS (via Builder or manually)
-Create `specs/fs/FS-xxx-name.requirement`:
-```gherkin
-@URS-xxx @RISK-xxx
-Feature: FS-xxx Feature Title
-  The system shall...
-  
-  Requirements:
-  - FR-xxx.1: First requirement
-  - FR-xxx.2: Second requirement
+### 4. Import Test Results
+
+```bash
+matrix release import-results results.json --releaseId REL-001
+```
+
+Or use the test command:
 
-  Scenario: Test case 1
-    Given ...
-    When ...
-    Then ...
+```bash
+matrix test import results.json -r REL-001
 ```
 
-### New Risk (manually)
-Create `specs/risk/RISK-xxx.yaml`:
-```yaml
-id: RISK-004
-type: risk
-title: Risk Title
-status: draft
-category: Security
-gamp_category: 4
-fs_ids:
-  - FS-001
-impact: high
-probability: medium
-risk_level: high
-risks:
-  - id: R-004.1
-    description: Risk description
-    impact: high
-    probability: medium
-mitigations:
-  - risk_id: R-004.1
-    control: Control measure
-    test: How to test
-residual_risk: acceptable
+The import process:
+- Creates a test run record
+- Stores individual scenario results (pass/fail)
+- Warns if any tests failed
+- Updates release status to "testing"
+
+### 5. View Test Results
+
+```bash
+matrix test list REL-001
 ```
 
-## Running Tests
+### 6. Handle Test Failures
+
+If tests fail, you have two GAMP-compliant options:
+
+**Option A: Fix the Code**
+1. Fix the failing functionality
+2. Re-run tests
+3. Import the new results
+
+**Option B: Log a Defect/Deviation**
+1. Go to Release Detail page: `http://localhost:3000/releases/REL-001`
+2. Find the **Defects & Deviations** section
+3. Click **Log Defect** for the failing scenario
+4. Provide:
+   - **Description**: What failed and why
+   - **Justification**: Why it's acceptable (workaround exists, low impact, etc.)
+   - **Status**: Open, Investigating, Resolved, or Accepted
 
-The `.requirement` files are standard Gherkin and can be executed with Cucumber:
+> [!IMPORTANT]
+> You cannot mark a release as "Released" if it has failing tests without corresponding Defect records.
+
+### 7. Update Release Status
 
 ```bash
-# Configure cucumber to find .requirement files
-npx cucumber-js specs/fs/**/*.requirement
+# Move to testing phase
+matrix release status REL-001 --status testing
+
+# Mark as released (requires all tests pass or defects logged)
+matrix release status REL-001 --status released
 ```
 
+### 8. List All Releases
+
+```bash
+matrix release list
+```
+
+---
+
+## CLI Reference
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `matrix init` | Initialize a new specs directory |
+| `matrix serve` | Start the dashboard server |
+| `matrix sync` | Parse `.requirement` files and update database |
+| `matrix search <query>` | Semantic search across specs |
+
+### Release Commands
+
+| Command | Description |
+|---------|-------------|
+| `matrix release list` | List all releases |
+| `matrix release create` | Create a new release |
+| `matrix release tag <id>` | Tag FS records to a release |
+| `matrix release status <id>` | Update release status |
+| `matrix release import-results <file>` | Import Cucumber JSON results |
+
+### Test Commands
+
+| Command | Description |
+|---------|-------------|
+| `matrix test import <file> -r <releaseId>` | Import Cucumber JSON results |
+| `matrix test list <releaseId>` | List test runs for a release |
+
+### Common Options
+
+| Option | Description |
+|--------|-------------|
+| `-p, --port <port>` | Port for serve (default: 3000) |
+| `-s, --specs <dir>` | Specs directory (default: ./specs) |
+| `-d, --db <path>` | Database path (default: ./matrix.db) |
+
+---
+
+## Dashboard Pages
+
+| Page | URL | Description |
+|------|-----|-------------|
+| Home | `/` | Stats, coverage, and traceability overview |
+| Specs | `/specs` | Browse and edit URS, FS, and Risks |
+| Matrix | `/matrix` | Full traceability matrix: URS → FS → Scenarios → Risks |
+| Releases | `/releases` | Release management and test results |
+| Builder | `/builder` | Visual editor for creating FS files |
+| Search | `/search` | Search across all artifacts |
+
+---
+
 ## GAMP 5 Compliance
 
-- **Category 4**: Configured products (authentication, session management)
-- **Category 5**: Custom applications (booking transactions)
-- **21 CFR Part 11**: Electronic records and signatures ready
-- **ALCOA+**: Data integrity principles for booking records
+- **V-Model Integration**: FS files serve as both specification (FS) and test protocol (OQ)
+- **Risk-Based Testing**: `@RISK-xxx` tags prioritize validation effort
+- **Automatic Traceability**: Tag-based linking generates audit-ready matrices
+- **Defect Management**: Failed tests require formal deviation records before release
+- **21 CFR Part 11 Ready**: Full audit trail of changes and test results
+
+---
+
+## Additional Documentation
+
+- [Developer Guide](./DEVELOPER_GUIDE.md) - Architecture and development setup
+- [GAMP & V-Model Philosophy](./GAMP_AND_V_MODEL.md) - Design rationale

package/bin/cli.js

@@ -2142,7 +2142,7 @@ function getDbPath() {
   if (process.env.MACHINE_DB_PATH) {
     return process.env.MACHINE_DB_PATH;
   }
-  return join3(process.cwd(), "machine.db");
+  return join3(process.cwd(), "matrix.db");
 }
 function getDb() {
   if (!db) {
@@ -3133,7 +3133,7 @@ import { existsSync, readFileSync } from "fs";
 import { join, resolve } from "path";
 var DEFAULT_CONFIG = {
   specsDir: "./specs",
-  dbPath: "./machine.db",
+  dbPath: "./matrix.db",
   port: 3000,
   rootDir: process.cwd()
 };
@@ -3204,13 +3204,30 @@ async function serveCommand(config) {
   };
   const packageRoot = join2(__dirname2, "..", "..");
   const hasProductionBuild = existsSync2(join2(packageRoot, ".next", "BUILD_ID"));
-  const script = hasProductionBuild ? "start" : "dev";
-  const runtime = hasBun() ? "bun" : "npm";
-  spawn(runtime, ["run", script], {
-    cwd: packageRoot,
-    env,
-    stdio: "inherit"
-  });
+  if (hasProductionBuild) {
+    const nextBin = join2(packageRoot, "node_modules", ".bin", "next");
+    const useLocalNext = existsSync2(nextBin);
+    if (useLocalNext) {
+      spawn(nextBin, ["start", "-p", String(config.port)], {
+        cwd: packageRoot,
+        env,
+        stdio: "inherit"
+      });
+    } else {
+      spawn("npx", ["next", "start", "-p", String(config.port)], {
+        cwd: packageRoot,
+        env,
+        stdio: "inherit"
+      });
+    }
+  } else {
+    const runtime = hasBun() ? "bun" : "npm";
+    spawn(runtime, ["run", "dev"], {
+      cwd: packageRoot,
+      env,
+      stdio: "inherit"
+    });
+  }
 }
 
 // src/commands/sync.ts
@@ -3220,7 +3237,7 @@ import { join as join4 } from "path";
 // src/config.ts
 var DEFAULT_CONFIG2 = {
   specsDir: "./specs",
-  dbPath: "./machine.db",
+  dbPath: "./matrix.db",
   port: 3000,
   rootDir: process.cwd()
 };
@@ -3585,7 +3602,7 @@ async function testCommand(config, action, options) {
 // bin/cli.ts
 var program2 = new Command;
 program2.name("machine").description("Requirements documentation system with semantic search").version("0.1.0");
-program2.command("serve").description("Start the documentation server").option("-p, --port <port>", "Port to run server on", "3000").option("-s, --specs <dir>", "Specs directory", "./specs").option("-d, --db <path>", "Database path", "./machine.db").action(async (options) => {
+program2.command("serve").description("Start the documentation server").option("-p, --port <port>", "Port to run server on", "3000").option("-s, --specs <dir>", "Specs directory", "./specs").option("-d, --db <path>", "Database path", "./matrix.db").action(async (options) => {
   const config = await loadConfig({
     port: parseInt(options.port, 10),
     specsDir: options.specs,
@@ -3593,7 +3610,7 @@ program2.command("serve").description("Start the documentation server").option("
   });
   await serveCommand(config);
 });
-program2.command("sync").description("Sync FS files to database and index steps").option("-s, --specs <dir>", "Specs directory", "./specs").option("-d, --db <path>", "Database path", "./machine.db").action(async (options) => {
+program2.command("sync").description("Sync FS files to database and index steps").option("-s, --specs <dir>", "Specs directory", "./specs").option("-d, --db <path>", "Database path", "./matrix.db").action(async (options) => {
   const config = await loadConfig({
     specsDir: options.specs,
     dbPath: options.db
@@ -3606,7 +3623,7 @@ program2.command("init").description("Initialize a new specs directory").option(
   });
   await initCommand(config);
 });
-program2.command("search <query>").description("Semantic search for steps").option("-n, --limit <n>", "Number of results", "10").option("-s, --specs <dir>", "Specs directory", "./specs").option("-d, --db <path>", "Database path", "./machine.db").action(async (query, options) => {
+program2.command("search <query>").description("Semantic search for steps").option("-n, --limit <n>", "Number of results", "10").option("-s, --specs <dir>", "Specs directory", "./specs").option("-d, --db <path>", "Database path", "./matrix.db").action(async (query, options) => {
   const config = await loadConfig({
     specsDir: options.specs,
     dbPath: options.db
@@ -3614,11 +3631,11 @@ program2.command("search <query>").description("Semantic search for steps").opti
   await searchCommand(config, query, parseInt(options.limit, 10));
 });
 var release = program2.command("release").description("Manage releases");
-release.command("list").description("List all releases").option("-d, --db <path>", "Database path", "./machine.db").action(async (options) => {
+release.command("list").description("List all releases").option("-d, --db <path>", "Database path", "./matrix.db").action(async (options) => {
   const config = await loadConfig({ dbPath: options.db });
   await releaseCommand(config, "list");
 });
-release.command("create").description("Create a new release").requiredOption("-v, --version <version>", "Release version (e.g., 1.0.0)").requiredOption("-n, --name <name>", "Release name").option("--notes <notes>", "Release notes").option("-d, --db <path>", "Database path", "./machine.db").action(async (options) => {
+release.command("create").description("Create a new release").requiredOption("-v, --version <version>", "Release version (e.g., 1.0.0)").requiredOption("-n, --name <name>", "Release name").option("--notes <notes>", "Release notes").option("-d, --db <path>", "Database path", "./matrix.db").action(async (options) => {
   const config = await loadConfig({ dbPath: options.db });
   await releaseCommand(config, "create", {
     version: options.version,
@@ -3626,24 +3643,24 @@ release.command("create").description("Create a new release").requiredOption("-v
     notes: options.notes
   });
 });
-release.command("tag <releaseId>").description("Tag features to a release").requiredOption("--fs <fsIds...>", "FS IDs to tag").option("-d, --db <path>", "Database path", "./machine.db").action(async (releaseId, options) => {
+release.command("tag <releaseId>").description("Tag features to a release").requiredOption("--fs <fsIds...>", "FS IDs to tag").option("-d, --db <path>", "Database path", "./matrix.db").action(async (releaseId, options) => {
   const config = await loadConfig({ dbPath: options.db });
   await releaseCommand(config, "tag", { releaseId, fsIds: options.fs });
 });
-release.command("status <releaseId>").description("Update release status").requiredOption("--status <status>", "New status (planning|testing|released)").option("-d, --db <path>", "Database path", "./machine.db").action(async (releaseId, options) => {
+release.command("status <releaseId>").description("Update release status").requiredOption("--status <status>", "New status (planning|testing|released)").option("-d, --db <path>", "Database path", "./matrix.db").action(async (releaseId, options) => {
   const config = await loadConfig({ dbPath: options.db });
   await releaseCommand(config, "status", { releaseId, status: options.status });
 });
-release.command("import-results <file>").description("Import Cucumber JSON results into a release").requiredOption("--releaseId <id>", "Release ID").option("-d, --db <path>", "Database path", "./machine.db").action(async (file, options) => {
+release.command("import-results <file>").description("Import Cucumber JSON results into a release").requiredOption("--releaseId <id>", "Release ID").option("-d, --db <path>", "Database path", "./matrix.db").action(async (file, options) => {
   const config = await loadConfig({ dbPath: options.db });
   await importResultsCommand(config, file, { releaseId: options.releaseId });
 });
 var test = program2.command("test").description("Manage test results");
-test.command("import <jsonPath>").description("Import Cucumber JSON test results").requiredOption("-r, --release <releaseId>", "Release ID").option("-d, --db <path>", "Database path", "./machine.db").action(async (jsonPath, options) => {
+test.command("import <jsonPath>").description("Import Cucumber JSON test results").requiredOption("-r, --release <releaseId>", "Release ID").option("-d, --db <path>", "Database path", "./matrix.db").action(async (jsonPath, options) => {
   const config = await loadConfig({ dbPath: options.db });
   await testCommand(config, "import", { releaseId: options.release, jsonPath });
 });
-test.command("list <releaseId>").description("List test runs for a release").option("-d, --db <path>", "Database path", "./machine.db").action(async (releaseId, options) => {
+test.command("list <releaseId>").description("List test runs for a release").option("-d, --db <path>", "Database path", "./matrix.db").action(async (releaseId, options) => {
   const config = await loadConfig({ dbPath: options.db });
   await testCommand(config, "list", { releaseId });
 });

package/bin/cli.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 /**
- * @nivora/machine CLI
+ * @nivora/matrix CLI
  * 
  * Commands:
  *   serve   - Start the documentation server
@@ -25,7 +25,7 @@ import { testCommand } from '../src/commands/test';
 const program = new Command();
 
 program
-  .name('machine')
+  .name('matrix')
   .description('Requirements documentation system with semantic search')
   .version('0.1.0');
 
@@ -34,7 +34,7 @@ program
   .description('Start the documentation server')
   .option('-p, --port <port>', 'Port to run server on', '3000')
   .option('-s, --specs <dir>', 'Specs directory', './specs')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (options) => {
     const config = await loadConfig({
       port: parseInt(options.port, 10),
@@ -48,7 +48,7 @@ program
   .command('sync')
   .description('Sync FS files to database and index steps')
   .option('-s, --specs <dir>', 'Specs directory', './specs')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (options) => {
     const config = await loadConfig({
       specsDir: options.specs,
@@ -73,7 +73,7 @@ program
   .description('Semantic search for steps')
   .option('-n, --limit <n>', 'Number of results', '10')
   .option('-s, --specs <dir>', 'Specs directory', './specs')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (query, options) => {
     const config = await loadConfig({
       specsDir: options.specs,
@@ -90,7 +90,7 @@ const release = program
 release
   .command('list')
   .description('List all releases')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (options) => {
     const config = await loadConfig({ dbPath: options.db });
     await releaseCommand(config, 'list');
@@ -102,7 +102,7 @@ release
   .requiredOption('-v, --version <version>', 'Release version (e.g., 1.0.0)')
   .requiredOption('-n, --name <name>', 'Release name')
   .option('--notes <notes>', 'Release notes')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (options) => {
     const config = await loadConfig({ dbPath: options.db });
     await releaseCommand(config, 'create', {
@@ -116,7 +116,7 @@ release
   .command('tag <releaseId>')
   .description('Tag features to a release')
   .requiredOption('--fs <fsIds...>', 'FS IDs to tag')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (releaseId, options) => {
     const config = await loadConfig({ dbPath: options.db });
     await releaseCommand(config, 'tag', { releaseId, fsIds: options.fs });
@@ -126,7 +126,7 @@ release
   .command('status <releaseId>')
   .description('Update release status')
   .requiredOption('--status <status>', 'New status (planning|testing|released)')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (releaseId, options) => {
     const config = await loadConfig({ dbPath: options.db });
     await releaseCommand(config, 'status', { releaseId, status: options.status });
@@ -136,7 +136,7 @@ release
   .command('import-results <file>')
   .description('Import Cucumber JSON results into a release')
   .requiredOption('--releaseId <id>', 'Release ID')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (file, options) => {
     const config = await loadConfig({ dbPath: options.db });
     await importResultsCommand(config, file, { releaseId: options.releaseId });
@@ -152,7 +152,7 @@ test
   .command('import <jsonPath>')
   .description('Import Cucumber JSON test results')
   .requiredOption('-r, --release <releaseId>', 'Release ID')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (jsonPath, options) => {
     const config = await loadConfig({ dbPath: options.db });
     await testCommand(config, 'import', { releaseId: options.release, jsonPath });
@@ -161,7 +161,7 @@ test
 test
   .command('list <releaseId>')
   .description('List test runs for a release')
-  .option('-d, --db <path>', 'Database path', './machine.db')
+  .option('-d, --db <path>', 'Database path', './matrix.db')
   .action(async (releaseId, options) => {
     const config = await loadConfig({ dbPath: options.db });
     await testCommand(config, 'list', { releaseId });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nivora/matrix",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Requirements documentation system with semantic search",
   "type": "module",
   "bin": {
@@ -12,7 +12,12 @@
   "files": [
     "bin",
     "dist",
-    ".next",
+    ".next/*.json",
+    ".next/*.js",
+    ".next/BUILD_ID",
+    ".next/package.json",
+    ".next/server",
+    ".next/static",
     "public",
     "next.config.ts"
   ],