zam-core 0.3.5 → 0.3.7

package/package.json

@@ -1,13 +1,25 @@
 {
   "name": "zam-core",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "The Symbiotic Learning Kernel: Elevating Human Intelligence through AI Collaboration.",
   "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "files": [
     "dist/",
     ".claude/skills/zam/",
     ".agent/skills/zam/",
     ".agents/skills/zam/",
+    "templates/personal/",
     "README.md",
     "LICENSE"
   ],
@@ -20,8 +32,10 @@
     "dev": "tsx src/cli/index.ts",
     "test": "vitest run",
     "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
     "lint": "biome check src/",
-    "format": "biome format --write src/"
+    "format": "biome format --write src/",
+    "desktop:prepare": "node scripts/prepare-desktop-bridge.mjs"
   },
   "repository": {
     "type": "git",
@@ -42,12 +56,16 @@
   "homepage": "https://github.com/zam-os/zam#readme",
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
+    "better-sqlite3": "^12.10.0",
     "commander": "^14.0.3",
-    "libsql": "^0.5.29",
     "ulid": "^3.0.2"
   },
+  "optionalDependencies": {
+    "libsql": "^0.5.29"
+  },
   "devDependencies": {
     "@biomejs/biome": "^2.4.8",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^25.5.0",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",

package/templates/personal/README.md

@@ -0,0 +1,31 @@
+# Your ZAM Personal Kernel
+
+This is your personal ZAM repository. Fork it, make it yours, and start ZAM from here.
+
+## What lives here
+
+- **`beliefs/`** — Your personal worldview. What you hold to be true. The ZAM agent will propose changes through conversation; you approve them by committing.
+- **`goals/`** — Your personal objectives. High-level goals decompose into tasks and learning tokens. Maintained collaboratively with the ZAM agent.
+
+## Getting started
+
+1. Fork this repository into your own account (e.g. `YourName/zam-personal`).
+2. Install ZAM: `npm install -g zam`
+3. Initialize the database: `zam init`
+4. Set your identity: `zam whoami --set <your-id>`
+5. Start a session: `zam session start --task "my first task"`
+
+## How it works
+
+Your personal repo holds the slow-changing parts of your ZAM experience: beliefs and goals. These are markdown files tracked in git. The git history is your approval trail — every committed change represents a conscious decision.
+
+Fast-changing data (learning tokens, cards, review history, sessions) lives in the ZAM database at `~/.zam/zam.db`.
+
+The core learning kernel lives in [`zam-os/zam`](https://github.com/zam-os/zam). It provides the CLI, the FSRS scheduler, the bridge protocol, and all the learning science. This repo provides *your* context.
+
+## Beliefs vs. Goals
+
+- **Beliefs** are premises — things you hold to be true. They guide how you interpret the world and how the ZAM agent interacts with you.
+- **Goals** are intentions — things you want to achieve. They decompose into tasks, which surface learning opportunities.
+
+Both evolve through conversation with the ZAM agent. Both require your explicit approval (a git commit) to take effect.

package/templates/personal/beliefs/README.md

@@ -0,0 +1,19 @@
+# My Beliefs
+
+This folder captures what you hold to be true. These are not facts — they are your current understanding of the world. They will evolve as you learn and grow.
+
+The ZAM agent reads these beliefs to understand your perspective. When new evidence or insight challenges a belief, the agent will propose a change through conversation. You approve changes by committing them.
+
+## Structure
+
+Each subfolder holds a belief and decomposes it into at most 7 components (Miller's number). Follow the same pattern as the [core beliefs](https://github.com/zam-os/zam/tree/main/beliefs).
+
+## Example
+
+You might start with beliefs about your professional domain:
+
+- **Software quality** — Readable code matters more than clever code.
+- **Learning** — Spaced repetition is the most effective way to retain technical knowledge.
+- **Collaboration** — Pair programming produces better results than solo work for complex problems.
+
+Create a subfolder for each belief. Write a `README.md` that states the belief and decomposes it.

package/templates/personal/goals/README.md

@@ -0,0 +1,19 @@
+# My Goals
+
+This folder captures what you want to achieve. Goals are intentions that decompose into actionable tasks and learning opportunities.
+
+The ZAM agent reads these goals to suggest tasks and prioritize your learning queue. When you complete a goal or your priorities shift, the agent will propose updates. You approve changes by committing them.
+
+## Structure
+
+Each subfolder holds a goal and decomposes it into at most 7 sub-goals or milestones (Miller's number). The hierarchy is:
+
+**Goals** (markdown, here) -> **Tasks** (task connector) -> **Tokens** (database)
+
+## Example
+
+- **Master backend architecture** — Understand the full request lifecycle, from HTTP handler to database query, in the system I work on.
+- **Run a 10K** — Build running endurance over the next 3 months through progressive training.
+- **Learn conversational Spanish** — Reach B1 level by practicing 20 minutes daily with spaced repetition.
+
+Create a subfolder for each goal. Write a `README.md` that states the goal and breaks it down.

package/templates/personal/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "zam-personal",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Your personal ZAM kernel — beliefs, goals, and identity.",
+  "dependencies": {
+    "zam": "^0.1.0"
+  }
+}