@principles/install-layout 0.2.6 → 0.3.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export declare const INSTALL_LAYOUT_VERSION: 1;
 export declare const INSTALL_LAYOUT_MODES: readonly ['canonical', 'legacy'];
 export type InstallLayoutMode = (typeof INSTALL_LAYOUT_MODES)[number];
-export declare const INSTALL_HOSTS: readonly ['codex', 'openclaw'];
+export declare const INSTALL_HOSTS: readonly ['codex', 'openclaw', 'workbuddy'];
 export type InstallHost = (typeof INSTALL_HOSTS)[number];
 export interface InstallManifest {
     layoutVersion: typeof INSTALL_LAYOUT_VERSION;
@@ -44,6 +44,13 @@ export interface InstallLayoutPaths {
      * links like any other runtime component.
      */
     codexAdapterDir: string;
+    /**
+     * WorkBuddy host adapter component (payload dir workbuddy-adapter/, npm
+     * name @principles/workbuddy-adapter; SPEC workbuddy-host-adapter §4.1).
+     * The WorkBuddy plugin wrapper resolves this dir to load the adapter entry
+     * the same way the Codex hook resolves the canonical runtime.
+     */
+    workbuddyAdapterDir: string;
 }
 export interface LayoutResolution {
     mode: InstallLayoutMode | 'missing';
@@ -65,6 +72,16 @@ export declare function parseInstallManifest(value: unknown): {
     error?: string;
 };
 export declare function getInstallLayoutPaths(homeDir: string): InstallLayoutPaths;
+/**
+ * WorkBuddy governance workspace (SPEC workbuddy-host-adapter §4.1 OD-07,
+ * frozen by Phase 0 probe P06 2026-10-12): an explicit user-level directory
+ * under the WorkBuddy config root, shared across projects, never auto-reused
+ * from Codex/OpenClaw state. projectDir stays the host cwd; this dir owns
+ * governance state (state.db / trajectory). The dir is CREATED only by the
+ * explicit setup flow — its absence means "not initialized", never a silent
+ * fallback to another host's database.
+ */
+export declare function getWorkbuddyWorkspaceDir(homeDir: string): string;
 export declare function resolveInstallLayout(options: ResolveInstallLayoutOptions): LayoutResolution;
 export declare function getConsoleServerEntry(paths: InstallLayoutPaths, mode: InstallLayoutMode): string;
 export declare function getConsoleWebIndex(paths: InstallLayoutPaths, mode: InstallLayoutMode): string;

package/dist/index.js

@@ -1,7 +1,7 @@
 import * as path from 'node:path';
 export const INSTALL_LAYOUT_VERSION = 1;
 export const INSTALL_LAYOUT_MODES = ['canonical', 'legacy'];
-export const INSTALL_HOSTS = ['codex', 'openclaw'];
+export const INSTALL_HOSTS = ['codex', 'openclaw', 'workbuddy'];
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -48,7 +48,7 @@ export function parseInstallManifest(value) {
         return { error: 'install_manifest_malformed: mode must be canonical or legacy' };
     }
     if (!Array.isArray(value.hosts) || value.hosts.length === 0 || !value.hosts.every(isHost)) {
-        return { error: 'install_manifest_malformed: hosts must contain codex and/or openclaw' };
+        return { error: 'install_manifest_malformed: hosts must contain codex, openclaw and/or workbuddy' };
     }
     const hosts = [...new Set(value.hosts)];
     const workspaces = parseWorkspaceList(value.workspaces);
@@ -78,8 +78,21 @@ export function getInstallLayoutPaths(homeDir) {
         openClawExtensionDir: path.join(openClawDir, 'extensions', 'principles-disciple'),
         releaseManagerDir: path.join(runtimeDir, 'release-manager'),
         codexAdapterDir: path.join(runtimeDir, 'codex-adapter'),
+        workbuddyAdapterDir: path.join(runtimeDir, 'workbuddy-adapter'),
     };
 }
+/**
+ * WorkBuddy governance workspace (SPEC workbuddy-host-adapter §4.1 OD-07,
+ * frozen by Phase 0 probe P06 2026-10-12): an explicit user-level directory
+ * under the WorkBuddy config root, shared across projects, never auto-reused
+ * from Codex/OpenClaw state. projectDir stays the host cwd; this dir owns
+ * governance state (state.db / trajectory). The dir is CREATED only by the
+ * explicit setup flow — its absence means "not initialized", never a silent
+ * fallback to another host's database.
+ */
+export function getWorkbuddyWorkspaceDir(homeDir) {
+    return path.join(path.resolve(homeDir), '.workbuddy', 'pd-workspace');
+}
 export function resolveInstallLayout(options) {
     const paths = getInstallLayoutPaths(options.homeDir);
     const parsed = parseInstallManifest(options.manifest);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/install-layout",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -22,7 +22,9 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node ../../scripts/build/check-dist-hygiene.mjs",
+    "clean": "node ../../scripts/build/clean-dist.mjs",
+    "typecheck": "tsc --noEmit",
     "test": "npm run build && vitest run"
   },
   "devDependencies": {

package/dist/index.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/index.test.js

@@ -1,69 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import * as path from 'node:path';
-import { getInstallLayoutPaths, getConsoleServerEntry, parseInstallManifest, resolveInstallLayout, mergeInstallManifestWorkspaces, } from './index.js';
-describe('install layout', () => {
-    it('resolves a canonical Codex-only install without OpenClaw', () => {
-        const paths = getInstallLayoutPaths('C:/Users/alice');
-        const result = resolveInstallLayout({
-            homeDir: 'C:/Users/alice',
-            manifest: { layoutVersion: 1, mode: 'canonical', hosts: ['codex'] },
-            canonicalRuntimeExists: true,
-            legacyExtensionExists: false,
-        });
-        expect(result.mode).toBe('canonical');
-        expect(result.manifest?.hosts).toEqual(['codex']);
-        expect(paths.openClawExtensionDir).toContain('.openclaw');
-        expect(paths.pluginDir).toContain('plugin');
-        expect(paths.installLayoutDir).toContain('install-layout');
-        expect(getConsoleServerEntry(result.paths, 'canonical')).toContain('.pd');
-    });
-    it('falls back to legacy only when the old extension exists', () => {
-        const result = resolveInstallLayout({
-            homeDir: '/home/alice',
-            manifest: undefined,
-            canonicalRuntimeExists: false,
-            legacyExtensionExists: true,
-        });
-        expect(result.mode).toBe('legacy');
-        expect(result.nextAction).toContain('migrate');
-    });
-    it('rejects malformed manifests instead of silently treating them as canonical', () => {
-        expect(parseInstallManifest({ layoutVersion: 1, mode: 'canonical', hosts: ['wat'] })).toEqual({
-            error: 'install_manifest_malformed: hosts must contain codex and/or openclaw',
-        });
-    });
-    it('accepts a manifest without workspaces (pre-PRI-624 manifests stay valid)', () => {
-        const { manifest, error } = parseInstallManifest({ layoutVersion: 1, mode: 'canonical', hosts: ['codex'] });
-        expect(error).toBeUndefined();
-        expect(manifest?.workspaces).toEqual([]);
-    });
-    it('parses workspaces as canonical absolute paths, deduped in insertion order', () => {
-        const { manifest, error } = parseInstallManifest({
-            layoutVersion: 1,
-            mode: 'canonical',
-            hosts: ['codex'],
-            workspaces: ['D:/Code/ws-a', 'D:\\Code\\ws-a', 'C:/work/ws b'],
-        });
-        expect(error).toBeUndefined();
-        expect(manifest?.workspaces?.length).toBe(2);
-        expect(manifest?.workspaces?.[0]).toBe(path.resolve('D:/Code/ws-a'));
-        expect(manifest?.workspaces).toContain(path.resolve('C:/work/ws b'));
-    });
-    it('rejects malformed workspace entries loudly', () => {
-        expect(parseInstallManifest({ layoutVersion: 1, mode: 'canonical', hosts: ['codex'], workspaces: [''] })).toEqual({
-            error: 'install_manifest_malformed: workspaces must be non-empty absolute paths',
-        });
-        expect(parseInstallManifest({ layoutVersion: 1, mode: 'canonical', hosts: ['codex'], workspaces: ['ws-a'] })).toEqual({
-            error: 'install_manifest_malformed: workspaces must be non-empty absolute paths',
-        });
-    });
-    it('merges a workspace into an existing manifest without duplicates', () => {
-        const merged = mergeInstallManifestWorkspaces({ layoutVersion: 1, mode: 'canonical', hosts: ['codex'], workspaces: ['D:/Code/ws-a'] }, 'D:\\Code\\ws-a');
-        expect(merged.length).toBe(1);
-        expect(merged[0]).toBe(path.resolve('D:/Code/ws-a'));
-    });
-    it('merge accepts unknown current manifests and starts a fresh list', () => {
-        const merged = mergeInstallManifestWorkspaces(undefined, 'D:/Code/ws-b');
-        expect(merged).toEqual([path.resolve('D:/Code/ws-b')]);
-    });
-});