reffy-cli 1.9.0 → 1.9.2

package/README.md

@@ -25,7 +25,6 @@ Command summary:
 
 - `reffy init`: runs the canonical first-run setup flow, creates the `.reffy/` and `.reffy/reffyspec/` structure, writes managed instructions, reindexes artifacts, and on first-run text output prints a copy/paste instruction for your agent harness.
 - `reffy bootstrap`: compatibility alias for `reffy init`.
-- `reffy migrate`: migrates a legacy `.references/` workspace into `.reffy/`.
 - `reffy doctor`: diagnoses required Reffy setup and workspace health.
 - `reffy reindex`: reconciles `.reffy/manifest.json` with `.reffy/artifacts` by adding missing files and removing stale entries.
 - `reffy validate`: validates `.reffy/manifest.json` against manifest v1 contract.
@@ -393,13 +392,14 @@ This is a navigational pointer that keeps the lineage explicit; the spec delta r
 For local development of this repo:
 
 ```bash
-npm install
-npm run build
-npm run check
-npm test
+corepack enable
+pnpm install
+pnpm build
+pnpm check
+pnpm test
 ```
 
-`npm install` runs this package's `prepare` step, which builds `dist/` automatically.
+`pnpm install` runs this package's `prepare` step, which builds `dist/` automatically. Use `pnpm reffy <args>` to exercise the built local CLI through `dist/cli.js`; this avoids accidentally invoking a globally installed `reffy` while working in this repo.
 
 ## Release Security
 

package/dist/cli.js

@@ -440,7 +440,6 @@ function usage() {
         "Commands:",
         "  init       Run the canonical first-run setup flow and refresh managed instructions.",
         "  bootstrap  Compatibility alias for init.",
-        "  migrate    Migrate a legacy .references workspace to the canonical .reffy layout.",
         "  doctor     Diagnose required Reffy setup and optional tool availability.",
         "  reindex    Scan .reffy/artifacts and add missing files to manifest.",
         "  validate   Validate .reffy/manifest.json against manifest v1 contract.",
@@ -1900,40 +1899,6 @@ async function main() {
         const repoRoot = parseRepoArg(rest);
         return await runSetupCommand("bootstrap", output, repoRoot);
     }
-    if (command === "migrate") {
-        const repoRoot = parseRepoArg(rest);
-        const workspace = await prepareCanonicalWorkspace(repoRoot);
-        const planning = await prepareCanonicalPlanningLayout(repoRoot);
-        const agents = await initAgents(repoRoot);
-        const skills = await scaffoldManagedSkills(repoRoot);
-        const payload = {
-            status: "ok",
-            command: "migrate",
-            workspace_mode: workspace.state.mode,
-            migrated_workspace: workspace.migrated,
-            created_workspace: workspace.created,
-            planning_mode: planning.state.mode,
-            migrated_planning_layout: planning.migrated,
-            created_planning_layout: planning.created,
-            refs_dir: workspace.state.canonicalDir,
-            ...agents,
-            skills,
-        };
-        if (output === "json") {
-            printResult(output, payload);
-        }
-        else {
-            console.log(workspace.message ?? `Workspace ready at ${workspace.state.canonicalDir}`);
-            if (planning.message) {
-                console.log(planning.message);
-            }
-            console.log(`Updated ${agents.root_agents_path}`);
-            console.log(`Updated ${agents.reffy_agents_path}`);
-            console.log(`Updated ${agents.reffyspec_agents_path}`);
-            console.log(`Skills: ${String(skills.written_skills.length)} managed (${skills.preserved_unmanaged.length} unmanaged preserved)`);
-        }
-        return 0;
-    }
     if (command === "reindex") {
         const repoRoot = parseRepoArg(rest);
         const store = new ReferencesStore(repoRoot);

package/dist/doctor.js

@@ -86,7 +86,7 @@ export async function runDoctor(repoRoot) {
         level: "optional",
         ok: workspace.mode !== "legacy",
         message: workspace.mode === "legacy"
-            ? "legacy .references workspace detected; run `reffy migrate` to adopt .reffy/"
+            ? "legacy .references workspace detected; run `reffy init` to adopt .reffy/"
             : ".reffy/ is the active workspace",
     });
     const commandDrift = await findCommandDrift(repoRoot);

package/dist/skills.js

@@ -214,7 +214,6 @@ export async function validateSkills(repoRoot, name) {
 export const KNOWN_COMMANDS = [
     "reffy init",
     "reffy bootstrap",
-    "reffy migrate",
     "reffy doctor",
     "reffy reindex",
     "reffy validate",
@@ -428,7 +427,7 @@ Use this first when a Reffy command misbehaves in an unfamiliar repo.
 2. Run \`reffy validate\` to confirm the manifest contract.
 3. Resolve each failure by class:
    - Missing \`.reffy/\` or \`AGENTS.md\`: run \`reffy init\`.
-   - Legacy \`.references/\` workspace: run \`reffy migrate\`.
+   - Legacy \`.references/\` workspace: run \`reffy init\`.
    - Invalid manifest: fix the reported entry, then re-run \`reffy validate\`.
    - Skill command drift: update the stale skill's \`commands\` list.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reffy-cli",
-  "version": "1.9.0",
+  "version": "1.9.2",
   "description": "Planning system for AI assisted development.",
   "keywords": [
     "reffy",
@@ -30,14 +30,6 @@
   "bin": {
     "reffy": "dist/cli.js"
   },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepare": "npm run build",
-    "dev": "tsx watch src/cli.ts",
-    "check": "tsc --noEmit",
-    "test": "npm run build && vitest run --coverage",
-    "test:watch": "vitest"
-  },
   "engines": {
     "node": ">=20"
   },
@@ -57,5 +49,13 @@
     "tsx": "^4.20.5",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "reffy": "node dist/cli.js",
+    "dev": "tsx watch src/cli.ts",
+    "check": "tsc --noEmit",
+    "test": "tsc -p tsconfig.json && vitest run --coverage",
+    "test:watch": "vitest"
   }
-}
+}