@deftai/directive-core 0.61.1 → 0.61.2

package/dist/init-deposit/init-deposit.js

@@ -14,6 +14,7 @@ import { resolveInstalledContentRoot } from "../deposit/resolve-content.js";
 import { readCorePackageVersion } from "../engine-version.js";
 import { ensureInitGitignoreLines, reconstituteDepositFromContent } from "./gitignore.js";
 import { buildLegacyRefusalJson, buildLegacyRefusalMessage, detectLegacyLayout, LEGACY_LAYOUT_REFUSED_EXIT_CODE, LegacyLayoutRefusedError, } from "./legacy-detect.js";
+import { printMigrateNudgeIfNeeded } from "./migrate.js";
 import { CANONICAL_INSTALL_ROOT, depositNeutralization, ensureTaskfile, writeAgentsMd, writeAgentsSkills, writeConsumerGitHooks, writeConsumerVbrief, writeInstallManifest, } from "./scaffold.js";
 export function parseInitArgv(canonicalArgv, userArgv = []) {
     const args = [...canonicalArgv, ...userArgv];
@@ -109,6 +110,7 @@ export function printNextSteps(result, io) {
     io.printf("  2. Deft skill auto-discovery is partially implemented — if your agent doesn't\n");
     io.printf('     start setup automatically, tell it: "Use AGENTS.md"\n');
     io.printf("  3. On first session, the agent will guide you through creating USER.md and PROJECT-DEFINITION.vbrief.json\n");
+    printMigrateNudgeIfNeeded(result.projectDir, io);
     io.printf("\n");
 }
 export async function runInitDeposit(args, io, seams = {}) {

package/dist/init-deposit/migrate.d.ts

@@ -85,4 +85,13 @@ export interface RunMigrateCliOptions {
  * stderr; config errors print to stderr; success prints to stdout.
  */
 export declare function runMigrateCli(options: RunMigrateCliOptions): number;
+/** One-line nudge for init/update/session completion when provenance is unstamped (#2059). */
+export declare const MIGRATE_COMPLETION_NUDGE = "[deft] One-time: run `directive migrate` to stamp npm provenance (idempotent). See content/UPGRADING.md.";
+/** True when a canonical-vendored deposit exists and lacks the npm-managed sentinel. */
+export declare function shouldEmitMigrateNudge(projectRoot: string, seams?: Pick<MigrateSeams, "isFile" | "readText">): boolean;
+export interface MigrateNudgeIo {
+    printf: (text: string) => void;
+}
+/** Prints {@link MIGRATE_COMPLETION_NUDGE} when {@link shouldEmitMigrateNudge} is true. */
+export declare function printMigrateNudgeIfNeeded(projectRoot: string, io: MigrateNudgeIo, seams?: Pick<MigrateSeams, "isFile" | "readText">): void;
 //# sourceMappingURL=migrate.d.ts.map

package/dist/init-deposit/migrate.js

@@ -193,4 +193,27 @@ export function runMigrateCli(options) {
     }
     return result.exitCode;
 }
+/** One-line nudge for init/update/session completion when provenance is unstamped (#2059). */
+export const MIGRATE_COMPLETION_NUDGE = "[deft] One-time: run `directive migrate` to stamp npm provenance (idempotent). See content/UPGRADING.md.";
+/** True when a canonical-vendored deposit exists and lacks the npm-managed sentinel. */
+export function shouldEmitMigrateNudge(projectRoot, seams = {}) {
+    const isFile = seams.isFile ?? existsSync;
+    const readText = seams.readText ?? defaultReadText;
+    const manifestPath = detectCanonicalVendoredManifest(projectRoot, isFile);
+    if (manifestPath === null)
+        return false;
+    const text = readText(manifestPath);
+    if (text === null)
+        return false;
+    const manifest = parseInstallManifest(text);
+    if (Object.keys(manifest).length === 0)
+        return false;
+    return !isNpmManaged(manifest);
+}
+/** Prints {@link MIGRATE_COMPLETION_NUDGE} when {@link shouldEmitMigrateNudge} is true. */
+export function printMigrateNudgeIfNeeded(projectRoot, io, seams = {}) {
+    if (shouldEmitMigrateNudge(projectRoot, seams)) {
+        io.printf(`\n${MIGRATE_COMPLETION_NUDGE}\n`);
+    }
+}
 //# sourceMappingURL=migrate.js.map

package/dist/init-deposit/refresh.js

@@ -18,6 +18,7 @@ import { DEV_FALLBACK } from "../platform/constants.js";
 import { gitPorcelain } from "../story-ready/git.js";
 import { parseInitArgv } from "./init-deposit.js";
 import { buildLegacyRefusalJson, buildLegacyRefusalMessage, detectLegacyLayout, LEGACY_LAYOUT_REFUSED_EXIT_CODE, LegacyLayoutRefusedError, } from "./legacy-detect.js";
+import { printMigrateNudgeIfNeeded } from "./migrate.js";
 import { CANONICAL_INSTALL_ROOT, depositNeutralization, writeAgentsMd, writeInstallManifest, } from "./scaffold.js";
 const INSTALLER_MANAGED_EXACT = new Set([
     "AGENTS.md",
@@ -231,6 +232,7 @@ export function printUpdateComplete(result, io) {
     if (result.versionSkewNotice) {
         io.printf(`\n${result.versionSkewNotice}\n`);
     }
+    printMigrateNudgeIfNeeded(result.projectDir, io);
     io.printf("\n");
 }
 export async function runRefreshDeposit(args, io, seams = {}) {

package/dist/session/session-start.js

@@ -1,4 +1,6 @@
 import { randomUUID } from "node:crypto";
+import { runningInsideDeftRepo } from "../doctor/paths.js";
+import { MIGRATE_COMPLETION_NUDGE, shouldEmitMigrateNudge } from "../init-deposit/migrate.js";
 import { disclosureLine } from "../policy/disclosure.js";
 import { resolvePolicy } from "../policy/resolve.js";
 import { runDefaultMode } from "../triage/welcome/default-mode.js";
@@ -263,6 +265,9 @@ export function runSessionStart(projectRoot, options = {}) {
             lines.push(message);
         }
     }
+    if (!runningInsideDeftRepo(projectRoot) && shouldEmitMigrateNudge(projectRoot)) {
+        lines.push(MIGRATE_COMPLETION_NUDGE);
+    }
     const payload = newRitualStatePayload({
         sessionId: (options.newSessionId ?? randomUUID)(),
         gitHead: gitHeadValue,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deftai/directive-core",
-  "version": "0.61.1",
+  "version": "0.61.2",
   "description": "TypeScript engine core for the Directive framework.",
   "type": "module",
   "main": "./dist/index.js",
@@ -221,8 +221,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@deftai/directive-content": "^0.61.1",
-    "@deftai/directive-types": "^0.61.1"
+    "@deftai/directive-content": "^0.61.2",
+    "@deftai/directive-types": "^0.61.2"
   },
   "scripts": {
     "build": "tsc -b",