@north-light/api 0.3.457 → 0.3.459

package/dist/api/contract.d.ts

@@ -1,5 +1,5 @@
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export declare const CONTRACT_LEVEL = "1.4";
+export declare const CONTRACT_LEVEL = "1.5";
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export declare const REQUIRED_CONTRACT_HEADER = "Crouter-Required-Contract";
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/contract.js

@@ -12,7 +12,7 @@
 //
 // PURITY (spec §3.1): Node built-ins + `src/api/*` only.
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export const CONTRACT_LEVEL = '1.4';
+export const CONTRACT_LEVEL = '1.5';
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export const REQUIRED_CONTRACT_HEADER = 'Crouter-Required-Contract';
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/dto/profiles.d.ts

@@ -112,6 +112,8 @@ export interface ProfileDTO {
     created_at: string;
     /** ISO timestamp of the most recent selection, or null if never selected. */
     last_used_at: string | null;
-    /** Absolute path of the profile's directory under its app's space (the legacy location of its pre-canvas markdown; the profile's documents live in the canvas). */
+    /** Absolute path of the profile's directory, `<app space>/profiles/<id>`: its settings root. The profile's documents live in the canvas, not here. */
+    profile_path: string;
+    /** @deprecated The same path as `profile_path`; kept for clients written before it existed. Removed in the next breaking release. */
     memory_path: string;
 }

package/dist/core/config.js

@@ -9,7 +9,7 @@ import { emitEvent } from './events/emit.js';
 import { atomicWriteJson, readJsonIfExists, ensureDir } from './fs-utils.js';
 import { scopeRoot, requireScopeRoot, findProjectScopeRoots, userScopeRoot } from './scope.js';
 import { listInstalledPluginsInRoot } from './installed-plugins.js';
-import { profileMemoryDir, listProfiles } from './profiles/manifest.js';
+import { profileDir, listProfiles } from './profiles/manifest.js';
 import { canonicalRoot, projectStore, userStore } from './scoped-state/paths.js';
 import { convertLegacyScopedStore, initializeFreshScopedStore } from './scoped-state/migrate.js';
 import { mutateRawSettings, readBookkeeping, readRawSettings, readRawSettingsWithRevision, replaceRawSettings, writeBookkeeping, writeRawSettings } from './scoped-state/settings.js';
@@ -47,7 +47,7 @@ function settingsOwnerForRoot(root) {
         return { store: projectStore(canonical), key: 'project', kind: 'project', root: canonical };
     }
     for (const profile of listProfiles()) {
-        const profilePath = canonicalRoot(profileMemoryDir(profile.profileId));
+        const profilePath = canonicalRoot(profileDir(profile.profileId));
         if (canonical === profilePath)
             return { store: userStore(userRoot), key: `profile:${profile.profileId}`, kind: 'profile', root: profilePath, profileId: profile.profileId };
     }
@@ -129,7 +129,7 @@ function rawSettingsOwnerForTarget(target) {
     if (!listProfiles().some((profile) => profile.profileId === target.profileId)) {
         throw notFound(`profile not found: ${target.profileId}`, { received: target.profileId, next: 'Run `crtr profile list` to see available profiles.' });
     }
-    return settingsOwnerForRoot(profileMemoryDir(target.profileId));
+    return settingsOwnerForRoot(profileDir(target.profileId));
 }
 export function readRawSettingsForTarget(target) {
     return readRawSettingsWithRevision(rawSettingsOwnerForTarget(target));
@@ -877,7 +877,7 @@ function readRawProfileConfig(profileId) {
     if (profileId === null || profileId === '')
         return null;
     try {
-        return readRawAtRoot(profileMemoryDir(profileId));
+        return readRawAtRoot(profileDir(profileId));
     }
     catch {
         return null;

package/dist/core/layout.d.ts

@@ -6,7 +6,7 @@ export declare function userRoot(): string;
 export declare function appsRoot(): string;
 export declare function secretsDir(): string;
 export declare function profileSpace(app: string, id: string): {
-    memory: string;
+    dir: string;
     env: string;
     home: string;
 };
@@ -15,7 +15,7 @@ export declare function layoutVersionFile(): string;
 export declare function userFilesRoot(): string;
 export declare function appSpace(app: string): {
     root: string;
-    memory: string;
+    profiles: string;
     conversations: string;
     nodes: string;
     files: string;

package/dist/core/layout.js

@@ -44,7 +44,7 @@ export function profileSpace(app, id) {
         throw new Error(`invalid profile id: ${id}`);
     const space = appSpace(app);
     return {
-        memory: join(space.memory, 'profiles', id),
+        dir: join(space.profiles, id),
         env: join(secretsDir(), 'env', basename(space.root), id),
         home: space.home,
     };
@@ -62,7 +62,7 @@ export function appSpace(app) {
     if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(id) || id === '.' || id === '..')
         throw new Error(`invalid app id: ${app}`);
     const root = join(appsRoot(), id);
-    return { root, memory: join(root, 'memory'), conversations: join(root, 'conversations'), nodes: join(root, 'nodes'), files: join(root, 'files'), home: join(root, 'home'), cache: join(root, 'cache') };
+    return { root, profiles: join(root, 'profiles'), conversations: join(root, 'conversations'), nodes: join(root, 'nodes'), files: join(root, 'files'), home: join(root, 'home'), cache: join(root, 'cache') };
 }
 /** The folder an isolated cron runs in: `<app space>/crons/<cron_id>/`. It belongs to the cron, not to the node that armed it. */
 export function cronFolder(app, cronId) {

package/dist/core/profiles/manifest.d.ts

@@ -1,7 +1,7 @@
 import type { ProfileManifest } from '../../types.js';
 import type { DeliveryLimits, ProfileProject, ProfileProjectMemory } from '../../api/dto/profiles.js';
 export declare const ROOT_PROFILE_ID = "root-00000000";
-export declare function profileMemoryDir(profileId: string): string;
+export declare function profileDir(profileId: string): string;
 export declare function assertProfileProjects(entries: unknown): asserts entries is ProfileProject[];
 export declare function assertDeliveryLimits(value: unknown): asserts value is DeliveryLimits;
 export interface ProfileEntry {

package/dist/core/profiles/manifest.js

@@ -21,7 +21,7 @@ export const ROOT_PROFILE_ID = 'root-00000000';
 const ROOT_PROFILE_NAME = 'root';
 function profileApp(manifest) { return manifest.grantee ?? 'app:terminal'; }
 function scaffoldProfile(profileId, manifest) {
-    ensureDir(profileSpace(profileApp(manifest), profileId).memory);
+    ensureDir(profileSpace(profileApp(manifest), profileId).dir);
 }
 function assertSafeProfileId(profileId) {
     if (!ID_SHAPE.test(profileId)) {
@@ -31,12 +31,12 @@ function assertSafeProfileId(profileId) {
         });
     }
 }
-export function profileMemoryDir(profileId) {
+export function profileDir(profileId) {
     assertSafeProfileId(profileId);
     const stored = getStoredProfile(userScopeRoot(), profileId);
     if (stored === null)
         throw notFound(`profile not found: ${profileId}`, { received: profileId });
-    return profileSpace(profileApp(stored.manifest), profileId).memory;
+    return profileSpace(profileApp(stored.manifest), profileId).dir;
 }
 // Profile operands resolve against the scoped-state rows.
 export function assertProfileProjects(entries) {
@@ -523,7 +523,7 @@ export function deleteProfile(profileId) {
         const space = profileSpace(profileApp(loadExactProfileManifest(profileId).manifest), profileId);
         if (!deleteStoredProfile(userScopeRoot(), profileId))
             throw notFound(`profile not found: ${profileId}`, { received: profileId });
-        rmSync(space.memory, { recursive: true, force: true });
+        rmSync(space.dir, { recursive: true, force: true });
         rmSync(space.env, { force: true });
     });
 }

package/dist/core/scoped-state/migrate.js

@@ -164,7 +164,7 @@ function importUser(db, root) {
             if (!manifest || typeof manifest !== 'object' || !Array.isArray(manifest.projects) || typeof manifest.name !== 'string' || typeof manifest.created_at !== 'string')
                 throw new Error(`legacy profile manifest is malformed: ${path}`);
             cachedStatement(db, 'INSERT INTO profiles(id,name,created_at,last_used_at,paused_at,default_kind,grantee,metadata_json) VALUES(?,?,?,?,?,?,?,?)').run(id, manifest.name, manifest.created_at, manifest.last_used_at ?? null, manifest.paused_at ?? null, manifest.default_kind ?? null, manifest.grantee ?? null, JSON.stringify(manifest.metadata ?? {}));
-            cachedStatement(db, 'INSERT INTO scope_owners(owner_key,kind,root,profile_id) VALUES(?,?,?,?)').run(`profile:${id}`, 'profile', canonicalRoot(profileSpace(manifest.grantee ?? 'app:terminal', id).memory), id);
+            cachedStatement(db, 'INSERT INTO scope_owners(owner_key,kind,root,profile_id) VALUES(?,?,?,?)').run(`profile:${id}`, 'profile', canonicalRoot(profileSpace(manifest.grantee ?? 'app:terminal', id).dir), id);
             const project = cachedStatement(db, 'INSERT INTO profile_projects(profile_id,path,position) VALUES(?,?,?)');
             const cap = cachedStatement(db, 'INSERT INTO legacy_project_caps(profile_id,path,memory) VALUES(?,?,?)');
             manifest.projects.forEach((p, position) => { project.run(id, p.path, position); if (p.memory !== undefined && p.memory !== 'content')

package/dist/core/scoped-state/profiles.js

@@ -31,7 +31,7 @@ export function pausedProfileIds(root) {
 export function insertStoredProfile(root, profile) {
     withScopedWrite(store(root), (db) => {
         cachedStatement(db, 'INSERT INTO profiles(id,name,created_at,last_used_at,paused_at,default_kind,grantee,metadata_json,delivery_limits_json) VALUES(?,?,?,?,?,?,?,?,?)').run(profile.profileId, profile.manifest.name, profile.manifest.created_at, profile.manifest.last_used_at, profile.manifest.paused_at, profile.manifest.default_kind ?? null, profile.manifest.grantee ?? null, JSON.stringify(profile.manifest.metadata ?? {}), JSON.stringify(profile.manifest.delivery_limits ?? {}));
-        cachedStatement(db, 'INSERT INTO scope_owners(owner_key,kind,root,profile_id) VALUES(?,?,?,?)').run(`profile:${profile.profileId}`, 'profile', canonicalRoot(profileSpace(profile.manifest.grantee ?? 'app:terminal', profile.profileId).memory), profile.profileId);
+        cachedStatement(db, 'INSERT INTO scope_owners(owner_key,kind,root,profile_id) VALUES(?,?,?,?)').run(`profile:${profile.profileId}`, 'profile', canonicalRoot(profileSpace(profile.manifest.grantee ?? 'app:terminal', profile.profileId).dir), profile.profileId);
         const insert = cachedStatement(db, 'INSERT INTO profile_projects(profile_id,path,position) VALUES(?,?,?)');
         profile.manifest.projects.forEach((project, position) => insert.run(profile.profileId, project.path, position));
     });

package/dist/core/scoped-state/settings.js

@@ -21,7 +21,10 @@ function ensureOwner(db, owner, access) {
     }
     if (row.root === owner.root)
         return;
-    if (owner.kind !== 'project' || owner.store.kind !== 'project' || owner.store.root !== owner.root) {
+    // A profile row is keyed by its id, checked above; its recorded root is a note of where the folder was. A profile
+    // folder that moved (`<app>/memory/profiles/<id>` → `<app>/profiles/<id>`) is rebound by the first write.
+    const profileMoved = owner.kind === 'profile' && owner.profileId !== undefined;
+    if (!profileMoved && (owner.kind !== 'project' || owner.store.kind !== 'project' || owner.store.root !== owner.root)) {
         throw new Error(`scoped SQL owner does not match its root: ${owner.key}`);
     }
     if (access === 'write')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.457",
+  "version": "0.3.459",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",