telo3-ai 6.1.0 → 6.2.0

package/README.md

@@ -4,26 +4,19 @@ A chat-first skill for less AI slop, less wasted context, and continuity between
 
 ## Install
 
-Requires Node.js 20+ for the installer; chat activation uses the AI's file tools, not Node.
+In your project, run one short command:
 
 ```bash
-npx telo3-ai@6.1.0 install
+npm i telo3-ai
 ```
 
-This copies the complete skill into your project, independent of npm's temporary cache. It detects existing Qoder, Claude, Gemini or Cursor project folders; otherwise uses the shared `.agents/skills/telo3` directory.
+That's it. The install adds the skill to your project and activates the always-on contract automatically (additive, idempotent, never overwrites your files; skips global installs). Then say **telo3** once in your AI chat.
 
-For a specific host:
+Prefer npx, or a specific builder? `npx telo3-ai` does the same; `npx telo3-ai install --agent qoder` targets a host (`claude`, `cursor`, `gemini`, `copilot`, `codex`, `agents`). Requires Node.js 20+.
 
-```bash
-npx telo3-ai@6.1.0 install --agent qoder
-# alternatives: claude, cursor, gemini, copilot, codex, agents
-```
-
-Then type **telo3** in your AI chat. Refresh the host's skill list if it caches discovery. The AI installs a small project instruction block using its file tools, preserves existing instructions, and confirms once. Future sessions resume from project instructions and the short memory summary.
-
-For manual/no-terminal installation, copy this package into the appropriate project's skill directory as `telo3/`, with `SKILL.md`, references, templates and runtime assets intact. Then say **telo3**. Plain web chat without project-file access cannot persist activation by itself.
+The skill is copied into your project, independent of npm's cache. It detects existing Qoder, Claude, Gemini or Cursor folders; otherwise uses the shared `.agents/skills/telo3` directory. Refresh the builder's skill list if it caches discovery. Future sessions resume from project instructions and the short memory summary.
 
-Optional direct activation: `npx telo3-ai@6.1.0 activate`. This also creates a durable project skill first.
+No terminal at all? Copy this package into the project's skill directory as `telo3/` (with `SKILL.md`, references, templates and runtime assets), then say **telo3**. Plain web chat without project-file access cannot persist activation by itself.
 
 ## Small core, on-demand depth
 

package/SKILL.md

@@ -17,7 +17,7 @@ Use your file tools; the user need not run commands.
 4. Reuse existing context in `project-context/`, `docs/project-context/`, or root. For substantial work, create missing doc skeletons from `templates/` and fill only evidenced information. A one-word activation does not authorize inventing a product or application code.
 5. Confirm once. Future sessions use the host's project instructions, without another keyword. A host with no file/instruction support cannot persist activation; state that limit, not fictitious success.
 
-Optional equivalent: `node <skill-dir>/cli.js activate <project>`. It first installs a durable project skill; `install [dir] --agent <host>` installs without activation. No auto-executing npm install scripts or hidden network calls.
+Optional equivalent: `node <skill-dir>/cli.js activate <project>`. It first installs a durable project skill; `install [dir] --agent <host>` installs without activation. The npm post-install only adds the skill and contract to the current project (additive, idempotent, never clobbers; skips global installs and opt-out); no network calls.
 
 ## Restore context without bloat
 

package/bootstrap/TELO3.md

@@ -1,5 +1,5 @@
 ---
-version: 6.1.0
+version: 6.2.0
 ---
 <!-- TELO3:BEGIN v{{VERSION}} -->
 ## Telo3 — always-on engineering contract

package/cli.js

@@ -250,9 +250,11 @@ switch (command) {
     console.log(`Telo3 v${getVersion()}`);
     break;
   case 'help':
-  case undefined:
     console.log(HELP);
     break;
+  case undefined:
+    cmdActivate(rest);
+    break;
   default:
     console.error(`Unknown command: ${command}`);
     console.error('Run "telo3 help" for usage information');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telo3-ai",
-  "version": "6.1.0",
+  "version": "6.2.0",
   "description": "Always-on engineering contract for AI coding agents: persistent project context, anti-slop discipline, measured token efficiency, and security/privacy/design quality. Mention telo3 once; it stays active.",
   "main": "index.js",
   "type": "module",
@@ -13,6 +13,7 @@
     "status": "node cli.js status",
     "activate": "node cli.js activate",
     "test": "node --test test/*.test.js",
+    "postinstall": "node scripts/postinstall.mjs",
     "verify:release": "node scripts/verify-release.mjs",
     "prepublishOnly": "npm test && npm run verify:release"
   },
@@ -59,6 +60,7 @@
     "templates/",
     "references/",
     "hooks/",
+    "scripts/postinstall.mjs",
     "cli.js",
     "index.js",
     "README.md",

package/scripts/postinstall.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * Safe, additive setup so `npm i telo3-ai` is the only command a user types.
+ * Installs the durable project skill and activates the always-on contract in
+ * the invoking project. Never clobbers user content, never fails the install.
+ * Skips global installs, opt-out, and the package's own directory.
+ * @license MIT
+ */
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { installSkill } from '../src/install.js';
+import { activate } from '../src/activate.js';
+
+const SOURCE = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+
+try {
+  const global = process.env.npm_config_global === 'true';
+  const target = resolve(process.env.INIT_CWD || process.cwd());
+  if (!global && !process.env.TELO3_SKIP && target !== SOURCE) {
+    const installed = installSkill(target, { agent: 'auto' });
+    activate(target, { skillPath: installed.skillPath });
+    process.stdout.write('Telo3 ready. Say "telo3" once in your AI chat.\n');
+  }
+} catch {
+  // Additive convenience only — never break `npm install`.
+  process.stdout.write('Telo3 installed. Run "npx telo3-ai" in your project to finish setup.\n');
+}