@ium/tfy-cli 0.1.0-preview.0 → 0.1.0-preview.1

package/README.md

@@ -18,8 +18,10 @@ Name mapping:
 
 TFY uses two public install channels only:
 
-- Stable channel: `@ium/tfy-cli` resolves to the most tested release through the npm `latest` dist-tag.
-- Public-test channel: `@ium/tfy-cli@preview` resolves to the newest public testing build with current development work included.
+- Stable channel: `@ium/tfy-cli` resolves to the most tested release through the npm `latest` dist-tag, but only after the first stable release exists.
+- Public-test channel: `@ium/tfy-cli@preview` resolves to the newest public testing build with current development work included. Use this explicit `@preview` form while TFY has no stable release.
+
+See the repository `docs/RELEASE_READINESS.md` for the canonical npm dist-tag cleanup and verification checklist.
 
 Exact versions remain installable with standard npm syntax, for example `@ium/tfy-cli@0.1.1` or `@ium/tfy-cli@0.1.1-preview.0`; npm version installs use `@<version>`, not `/v<version>`.
 
@@ -41,6 +43,8 @@ This is not GA/production-ready. TFY does not claim private Codex hook intercept
 
 The installer downloads from the matching GitHub Release tag and verifies the `.sha256` file before installing. Preview versions keep the full preview tag, for example `v0.1.1-preview.0`, while release asset names use the base version, for example `tfy-0.1.1-linux-x86_64.tar.gz`.
 
+After a successful install, npm prints opt-in human setup guidance only. It does **not** edit `.bashrc`, `.zshrc`, fish config, or any other shell startup file. On supported Linux bash, run `tfy setup --human` to dry-run the one-time hook install, or `tfy setup --human --apply` to enable auto-activation only for trusted repos that have a TFY marker from `tfy start --human`.
+
 
 ## Publishing note
 
@@ -51,4 +55,4 @@ node scripts/npm-publish-plan.js --version 0.1.1-preview.0 --channel preview --s
 node scripts/npm-publish-plan.js --version 0.1.1 --channel stable --source-ref main
 ```
 
-The helper validates the channel/version/source metadata and prints the exact `npm publish` command; it does not publish.
+The helper validates the channel/version/source metadata and prints the exact `npm publish` command; it does not publish. Preview publishes must keep using `--tag preview`; `latest` remains stable-only.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ium/tfy-cli",
-  "version": "0.1.0-preview.0",
+  "version": "0.1.0-preview.1",
   "description": "TFY Developer Preview CLI installer. Installs the `tfy` command; not GA.",
   "license": "MIT",
   "repository": {

package/scripts/install.js

@@ -19,6 +19,10 @@ function log(message) {
   process.stderr.write(`[tfy installer] ${message}\n`);
 }
 
+function logHumanOptInGuidance() {
+  log('human auto-activation is opt-in. To enable it once for trusted TFY-marked repos: tfy setup --human --apply');
+}
+
 function fail(message) {
   process.stderr.write(`[tfy installer] error: ${message}\n`);
   process.exit(1);
@@ -50,6 +54,7 @@ function copyLocalBinary(source, destination = manualInstallDestination(source))
   fs.copyFileSync(source, destination);
   ensureExecutable(destination);
   log(`installed local TFY binary from ${source}`);
+  logHumanOptInGuidance();
   return destination;
 }
 
@@ -174,6 +179,7 @@ async function installFromRelease(options = {}) {
   await downloadFile(checksumUrl, checksumPath);
   installVerifiedArchive({ archivePath, checksumPath, asset, platformTarget, vendorDirectory, destinationBinary });
   log(`installed ${destinationBinary}`);
+  logHumanOptInGuidance();
 }
 
 async function main() {
@@ -200,6 +206,7 @@ module.exports = {
   download,
   installFromRelease,
   installLocalBinary,
+  logHumanOptInGuidance,
   manualInstallDestination,
   installVerifiedArchive,
   listArchiveEntries,