create-t2k 0.2.0 → 0.3.0

package/README.md

@@ -4,7 +4,7 @@ Create a runnable local T2K project with a synthetic ontology, accepted facts,
 a Decision Context, two executable policies, and disjoint replay evidence.
 
 ```bash
-npx create-t2k my-decision-loop
+npx create-t2k@latest my-decision-loop
 cd my-decision-loop
 npm start
 ```
@@ -26,10 +26,32 @@ That command records authorization, execution receipts, observations, computed
 rewards, held-out evaluation, independent promotion, and exact rollback in the
 open reference runtime.
 
+Stop the local containers without deleting lifecycle data with `npm run
+db:down`. Use the explicitly destructive `npm run db:reset` only when you
+intend to delete the disposable local database volume.
+
+To expose ontology validation, compilation, policy execution, replay, and
+reward evaluation to an MCP host, add:
+
+```json
+{
+  "mcpServers": {
+    "t2k": {
+      "command": "npx",
+      "args": ["-y", "@t2kai/mcp@latest"]
+    }
+  }
+}
+```
+
+This starts read-only and does not send project data to a hosted service. See
+the [`@t2kai/mcp` guide](https://github.com/sigaihealth/t2k-core/blob/main/packages/mcp/README.md)
+before enabling database access or agent writes.
+
 Use `--no-install` to generate files without running `npm install`:
 
 ```bash
-npx create-t2k my-decision-loop --no-install
+npx create-t2k@latest my-decision-loop --no-install
 ```
 
 The command refuses to write into a non-empty directory. Node.js 20.10 or newer

package/bin/create-t2k.mjs

@@ -24,7 +24,8 @@ Options:
   -v, --version  Show the package version
 
 The default directory is my-t2k-project. Existing non-empty directories are
-never overwritten.`;
+never overwritten. Generated projects include decision and optional
+persisted-lifecycle examples.`;
 
 try {
   const options = parseArguments(process.argv.slice(2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-t2k",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Create a local T2K governed-decision project in minutes.",
   "license": "Apache-2.0",
   "keywords": [

package/src/scaffold.mjs

@@ -171,6 +171,7 @@ export async function scaffoldProject({
   stdout.write("  npm start\n\n");
   stdout.write("The first run computes a recommendation; a human must still authorize it.\n");
   stdout.write("Run `npm run db:up && npm run lifecycle` for the persisted closed loop.\n");
+  stdout.write("Use `npm run db:down` to stop it or `npm run db:reset` to delete its volume.\n");
 
   return { targetPath, projectName };
 }

package/template/README.md.template

@@ -40,7 +40,29 @@ The actors who propose, evaluate, promote, and roll back are deliberately
 separate synthetic identities. The event ledger is hash-chained and append-only.
 In production, authenticate those actor IDs and enforce organization roles in
 the calling service; the local runtime is not an identity provider. To remove
-the local database and its volume, run `npm run db:down`.
+the local containers while preserving their volume, run `npm run db:down`. To
+explicitly delete the disposable local volume and all lifecycle data in it, run
+`npm run db:reset`.
+
+## Connect an MCP host
+
+Expose validation, compilation, policy execution, replay, and reward evaluation
+to an MCP host with the safe database-free mode:
+
+```json
+{
+  "mcpServers": {
+    "t2k": {
+      "command": "npx",
+      "args": ["-y", "@t2kai/mcp@latest"]
+    }
+  }
+}
+```
+
+The MCP server does not expose human authorization or promotion operations.
+Read <https://t2k.ai/developers/> before enabling its optional Postgres or agent
+mutation modes.
 
 ## Change the example
 

package/template/package.json.template

@@ -10,10 +10,11 @@
     "start": "node src/run.mjs",
     "check": "node src/run.mjs",
     "db:up": "docker compose up -d --wait",
-    "db:down": "docker compose down -v",
+    "db:down": "docker compose down",
+    "db:reset": "docker compose down -v",
     "lifecycle": "node src/lifecycle.mjs"
   },
   "dependencies": {
-    "@t2kai/core": "^0.2.0"
+    "@t2kai/core": "^0.3.0"
   }
 }