@deftai/directive-content 0.58.0 → 0.59.0

package/Taskfile.yml

@@ -268,15 +268,15 @@ includes:
   changelog:
     taskfile: ./tasks/changelog.yml
     optional: true
-  # Wipe-and-reinstall relocator (#992 PR2). Exposes `task relocate` --
-  # forwards user-facing flags (`--confirm` / `--dry-run` / `--force` /
-  # `--rollback` / `--no-snapshot` / `--json` / `--quiet`) via
-  # {{.CLI_ARGS}}; per `conventions/task-caching.md` no `sources:` /
-  # `generates:` so the recovery flags reach the script (#574). The
-  # include is `optional: true` for rolling-merge tolerance.
-  relocate:
-    taskfile: ./tasks/relocate.yml
-    optional: true
+  # NOTE (#2022 Python-purge): the `relocate:` include was DROPPED from the
+  # consumer task surface. The relocate task shelled into scripts/relocate.py
+  # via `uv run python` -- the sole remaining consumer-exposed Python coupling
+  # on the deft task surface. It is intentionally NOT wired here anymore. The
+  # canonical consumer (re)install / relocate path is the npm installer
+  # (`npm i -g @deftai/directive@latest`; see UPGRADING.md / #1912, where
+  # relocate is a back-compat / legacy bridge only). tasks/relocate.yml is
+  # retained (un-wired) and the helper scripts/relocate.py stays for #1860
+  # (big-bang Python delete) to remove.
   # N7 (#1147): slice:* fragment exposing `task slice:record-existing`
   # (retrofit slices.jsonl for hand-filed cohorts) + `task slice:list`
   # (read surface). Include key `slice-record` (not `slice`) so the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-content",
-  "version": "0.58.0",
+  "version": "0.59.0",
   "description": "Shippable Directive framework content in the consumer .deft/core/ layout (C1 flatten), plus the engine surfaces (.githooks/, Taskfile.yml, tasks/, scripts/) the deposit wires. Refs #11, #1669, #1967.",
   "type": "module",
   "files": [

package/packs/rules/rules-pack-0.1.json

@@ -4031,7 +4031,7 @@
       "id": "main-001",
       "tier": "MUST",
       "domain": "main",
-      "text": "Before any other instruction in this file or in the consumer AGENTS.md, run `deft-install gate` (the node-independent read-only health gate in the frozen installer binary; #1933 Option 3).",
+      "text": "Cold-start check: deft runs from the npm-installed engine (`npm i -g @deftai/directive`). If neither `deft` nor `directive` will run on this machine, do not proceed with the instructions below -- recover first (#1933 Option 1, deprecate-by-disuse).",
       "path": "main.md",
       "body": null
     },
@@ -4039,7 +4039,7 @@
       "id": "main-002",
       "tier": "MUST",
       "domain": "main",
-      "text": "If exit code is 0, continue.",
+      "text": "To recover: read `.deft/core/UPGRADING.md`, find the section whose \"Applies when\" clause matches your symptom, and follow that section verbatim before any other instruction in this file or in the consumer AGENTS.md.",
       "path": "main.md",
       "body": null
     },
@@ -4047,7 +4047,7 @@
       "id": "main-003",
       "tier": "MUST",
       "domain": "main",
-      "text": "Otherwise: read `.deft/core/UPGRADING.md`, find the section whose \"Applies when\" clause matches the state vector printed by the gate, and follow that section verbatim. Respect any \"Restart required\" directive -- if present, stop and tell the user to start a fresh session after cleanup commands complete.",
+      "text": "Respect any \"Restart required\" directive -- if present, stop and tell the user to start a fresh session after cleanup commands complete. Otherwise continue.",
       "path": "main.md",
       "body": null
     },

package/scripts/doctor.py

@@ -734,8 +734,9 @@ def _check_install_path_consistency(project_root: Path, install_root: str | None
                 "`.deft\\core\\run agents:refresh` (Windows) to rewrite "
                 "AGENTS.md to match the on-disk framework -- pick this if "
                 "the framework on disk is correct; OR "
-                "(b) run `task relocate:relocate -- --confirm` to move the "
-                "framework to the path AGENTS.md / the manifest claims -- "
+                "(b) run `npx @deftai/directive update` to (re)deposit the "
+                "framework at the path AGENTS.md / the manifest claims (the "
+                "npm CLI project deposit, #1912) -- "
                 "pick this if AGENTS.md is correct. The YAML manifest (if "
                 "present) is authoritative for the install-layout contract. "
                 "See UPGRADING.md for the canonical drift-repair walkthrough."
@@ -748,7 +749,7 @@ def _check_install_path_consistency(project_root: Path, install_root: str | None
                 "claimed_dir_exists": False,
                 "fallback_info_note": fallback_info_note or None,
                 "suggested_fix": ".deft/core/run agents:refresh",
-                "suggested_fix_alt": "task relocate:relocate -- --confirm",
+                "suggested_fix_alt": "npx @deftai/directive update",
             },
         )
     # Note: this check intentionally does NOT verify the YAML manifest

package/tasks/relocate.yml

@@ -1,56 +1,26 @@
 version: '3'
 
-# tasks/relocate.yml -- wipe-and-reinstall relocator surface (#992 PR2).
+# tasks/relocate.yml -- DROPPED from the consumer task surface (#2022).
 #
-# Wires `task relocate` to scripts/relocate.py with full {{.CLI_ARGS}}
-# pass-through so operators can compose flags as documented in the script
-# docstring (--project-root / --framework-source / --force / --confirm /
-# --no-confirm / --dry-run / --rollback / --snapshot / --no-snapshot /
-# --json / --quiet).
+# The relocate task previously wired `task relocate` (namespaced
+# `relocate:relocate`) to `uv run python scripts/relocate.py` -- the sole
+# remaining consumer-exposed Python coupling on the deft task surface. Per
+# the #2022 Python-purge readiness gate it has been REMOVED from the
+# consumer-exposed task graph: this fragment is no longer referenced by the
+# root Taskfile.yml `includes:` block and exposes no task.
 #
-# Per `conventions/task-caching.md` (#574): NO `sources:` / `generates:`
-# declarations because user-facing recovery flags (`--force`, `--confirm`,
-# `--rollback`, `--dry-run`) flow via {{.CLI_ARGS}} -- a go-task cache
-# short-circuit would silently drop the recovery flag and leave the
-# operator following the docs against an exit-0 no-op (the same hazard
-# `task prd:render -- --force` hit at #574).
+# Canonical consumer (re)install / relocate path is now the npm installer
+# (`npm i -g @deftai/directive@latest`), NOT a bundled task -- see
+# content/UPGRADING.md "Manual drift repair" and #1912 (the relocator is a
+# back-compat / legacy bridge only, never a routine-upgrade path). The
+# underlying helper scripts/relocate.py is intentionally retained for #1860
+# (big-bang Python delete) to remove; this story only drops the consumer
+# task surface.
 #
-# Path resolution uses the same {{.TASKFILE_DIR}} / joinPath idiom every
-# other fragment uses (#566) so the dispatch resolves correctly under
-# Windows / macOS / Linux. The dispatched script lives at
-# {{.DEFT_ROOT}}/scripts/relocate.py with helper modules at
-# {{.DEFT_ROOT}}/scripts/_relocate_states.py and
-# {{.DEFT_ROOT}}/scripts/_relocate_snapshot.py.
-#
-# Usage notes for operators:
-#
-# - Bare invocation against a project root that needs relocating prompts
-#   `[y/N]` on stdin (auto-prompt never auto-wipe per the active vBRIEF).
-# - For scripted use, pass `--confirm` to skip the prompt (or
-#   `--no-snapshot` for hermetic test fixtures).
-# - For consumer projects: the canonical entry point is the webinstaller
-#   bootstrap (`upgrade.sh` / `upgrade.ps1` in the separate `webinstaller`
-#   repo) which fetches a fresh framework copy to a temp dir and runs the
-#   relocator from THAT copy -- the in-place framework about to be wiped
-#   never executes its own wipe.
-# - `task relocate -- --rollback` extracts the most recent snapshot back
-#   into project root.
-#
-# Companion script: scripts/relocate.py
-# Companion tests:  tests/relocate/test_state_matrix.py
-#                   tests/relocate/test_preflight.py
-# Refs: #992 (parent issue), #11 (.deft/core/ origin),
-#       #768 (managed-section v2 contract), #794 (_wrap_legacy_in_markers),
-#       #884 (consent-gate convention).
+# This file is retained (un-wired) so the framework's own Taskfile
+# content-contract tests keep a stable fixture. The DEFT_ROOT joinPath var
+# below preserves the #566 per-subfile path-resolution idiom for any future
+# maintainer-side re-wiring.
 
 vars:
   DEFT_ROOT: '{{joinPath .TASKFILE_DIR ".."}}'
-
-tasks:
-  relocate:
-    desc: "Wipe-and-reinstall relocator (#992 PR2) -- task relocate [-- --confirm | --dry-run | --force | --rollback | --json | --quiet]"
-    dir: '{{.USER_WORKING_DIR}}'
-    env:
-      PYTHONUTF8: "1"
-    cmds:
-      - uv --project "{{.DEFT_ROOT}}" run python "{{.DEFT_ROOT}}/scripts/relocate.py" {{.CLI_ARGS}}

package/templates/agents-entry.md

@@ -206,6 +206,5 @@ Directive product commands use the `/deft:directive:*` namespace (#418 / #1670).
 
 **CLI compatibility:**
 
-- .deft/core/run bootstrap         — CLI setup (terminal users)
-- .deft/core/run spec              — CLI spec generation
+The legacy Python `.deft/core/run` CLI is deprecated and is no longer a load-bearing operator path (#1933 Option 1, deprecate-by-disuse). Use the agent-driven setup skill for first-time setup and project/spec generation; if `deft` or `directive` will not run, read `.deft/core/UPGRADING.md`.
 <!-- /deft:managed-section -->