chore: update changelog and package.json for version 0.6.0 release; add package integrity tests

Author: tercel

CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-02-23
+
+### Fixed
+- **Critical publishing bug** — Previous releases (0.1.0–0.5.0) shipped without `dist/` directory because `.gitignore` excluded `dist/` and npm fell back to it as the exclusion list (no `files` field or `.npmignore` existed). `require("apcore-js")` and `import("apcore-js")` would fail at runtime with "module not found". This is the first version where the package is actually usable from npm.
+- **VERSION constant out of sync** — `VERSION` export was stuck at `'0.3.0'` while `package.json` was at `0.5.0`.
+
+### Added
+- `"files": ["dist", "README.md"]` in `package.json` to restrict npm publish scope to compiled output only (previously published src/, tests/, planning/, .claude/, .github/ — 902 KB of dev files).
+- `"prepublishOnly": "pnpm run build"` script to ensure `tsc` runs before every `npm publish` / `pnpm publish`.
+- **Package integrity test suite** (`tests/test-package-integrity.test.ts`) — 10 tests that verify:
+  - `files` field configuration and exclusion of dev directories
+  - `prepublishOnly` script exists and invokes build
+  - All entry points (`main`, `types`, `exports`) resolve to files in `dist/`
+  - `dist/index.js` is importable and exports all 16+ core symbols
+  - `VERSION` constant matches `package.json` version
+
+### Changed
+- **Version aligned with apcore-python** — Bumped to 0.6.0 for cross-language version consistency.
+- Package size reduced from 192.6 kB (source-only, broken) to 86.3 kB (compiled, working).
+
 ## [0.5.0] - 2026-02-23
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "apcore-js",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "AI-Perceivable Core — schema-driven module development framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,12 +11,17 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "pnpm run build"
   },
   "engines": {
     "node": ">=18.0.0"

src/index.ts

@@ -96,4 +96,4 @@ export { ContextLogger, ObsLoggingMiddleware } from './observability/context-log
 export { TraceContext } from './trace-context.js';
 export type { TraceParent } from './trace-context.js';
 
-export const VERSION = '0.3.0';
+export const VERSION = '0.6.0';

tests/test-package-integrity.test.ts

@@ -0,0 +1,97 @@
+/**
+ * Package integrity tests.
+ *
+ * Verifies that the npm package is correctly configured for publishing:
+ * - Entry points (main, types, exports) reference files that exist after build
+ * - The "files" field restricts what gets published
+ * - The "prepublishOnly" script ensures build runs before publish
+ * - The VERSION constant matches package.json version
+ */
+
+import { describe, it, expect } from 'vitest';
+import { existsSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { readFileSync } from 'node:fs';
+
+const ROOT = resolve(import.meta.dirname, '..');
+const pkg = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf-8'));
+
+describe('package.json publishing config', () => {
+  it('has "files" field that includes dist', () => {
+    expect(pkg.files).toBeDefined();
+    expect(pkg.files).toContain('dist');
+  });
+
+  it('"files" does not include source or dev directories', () => {
+    const forbidden = ['src', 'tests', 'planning', 'coverage', '.claude', '.github'];
+    for (const dir of forbidden) {
+      expect(pkg.files, `files should not include "${dir}"`).not.toContain(dir);
+    }
+  });
+
+  it('has prepublishOnly script that runs build', () => {
+    expect(pkg.scripts.prepublishOnly).toBeDefined();
+    expect(pkg.scripts.prepublishOnly).toContain('build');
+  });
+});
+
+describe('dist entry points exist', () => {
+  it('main entry (./dist/index.js) exists', () => {
+    const mainPath = resolve(ROOT, pkg.main);
+    expect(existsSync(mainPath), `${pkg.main} should exist`).toBe(true);
+  });
+
+  it('types entry (./dist/index.d.ts) exists', () => {
+    const typesPath = resolve(ROOT, pkg.types);
+    expect(existsSync(typesPath), `${pkg.types} should exist`).toBe(true);
+  });
+
+  it('exports "." import entry exists', () => {
+    const importPath = resolve(ROOT, pkg.exports['.'].import);
+    expect(existsSync(importPath), `exports["."].import should exist`).toBe(true);
+  });
+
+  it('exports "." types entry exists', () => {
+    const typesPath = resolve(ROOT, pkg.exports['.'].types);
+    expect(existsSync(typesPath), `exports["."].types should exist`).toBe(true);
+  });
+});
+
+describe('dist exports are loadable', () => {
+  it('can import the package entry point', async () => {
+    const mod = await import('../dist/index.js');
+    expect(mod).toBeDefined();
+    expect(typeof mod).toBe('object');
+  });
+
+  it('exports key symbols', async () => {
+    const mod = await import('../dist/index.js');
+    // Core classes/functions that consumers depend on
+    expect(mod.Registry).toBeDefined();
+    expect(mod.Executor).toBeDefined();
+    expect(mod.Context).toBeDefined();
+    expect(mod.Config).toBeDefined();
+    expect(mod.ACL).toBeDefined();
+    expect(mod.CancelToken).toBeDefined();
+    expect(mod.MiddlewareManager).toBeDefined();
+    expect(mod.ExtensionManager).toBeDefined();
+    expect(mod.AsyncTaskManager).toBeDefined();
+    expect(mod.BindingLoader).toBeDefined();
+    expect(mod.SchemaLoader).toBeDefined();
+    expect(mod.SchemaValidator).toBeDefined();
+    expect(mod.TracingMiddleware).toBeDefined();
+    expect(mod.MetricsCollector).toBeDefined();
+    expect(mod.ContextLogger).toBeDefined();
+    expect(mod.TraceContext).toBeDefined();
+    // Error classes
+    expect(mod.ModuleError).toBeDefined();
+    expect(mod.ErrorCodes).toBeDefined();
+  });
+});
+
+describe('VERSION constant', () => {
+  it('matches package.json version', async () => {
+    const mod = await import('../dist/index.js');
+    expect(mod.VERSION).toBe(pkg.version);
+  });
+});