scene-capability-engine 3.6.65 → 3.6.67

package/lib/commands/session.js

@@ -1,6 +1,7 @@
 const chalk = require('chalk');
 const { SessionStore } = require('../runtime/session-store');
 const { captureTimelineCheckpoint } = require('../runtime/project-timeline');
+const { buildProjectChannelOutput } = require('../project/project-channel-output');
 
 function registerSessionCommands(program) {
   const session = program
@@ -13,6 +14,11 @@ function registerSessionCommands(program) {
     .option('--tool <tool>', 'Target tool (codex|claude|cursor|generic)', 'generic')
     .option('--agent-version <version>', 'Target agent version for compatibility tracking')
     .option('--id <id>', 'Custom session id')
+    .option('--project-id <projectId>', 'Bind session to a project-local collaboration context')
+    .option('--channel <channelId>', 'Bind session to a collaboration channel')
+    .option('--scene <sceneId>', 'Channel-local active scene override')
+    .option('--spec <specId>', 'Channel-local active spec override')
+    .option('--doc <docId>', 'Channel-local active doc override')
     .option('--json', 'Output as JSON')
     .action(async (objective, options) => {
       try {
@@ -31,7 +37,8 @@ function registerSessionCommands(program) {
           objective: objective || '',
           sessionId: options.id,
         });
-        _printSessionResult('session_start', created, options.json);
+        const metadata = await _maybeBindProjectChannel(store, created.session_id, options);
+        _printSessionResult('session_start', created, options.json, metadata);
       } catch (error) {
         _exitWithError(error, options.json);
       }
@@ -41,6 +48,11 @@ function registerSessionCommands(program) {
     .command('resume [sessionRef]')
     .description('Resume a session by id, or use latest by default')
     .option('--status <status>', 'Status to set after resume', 'active')
+    .option('--project-id <projectId>', 'Bind resumed session to a project-local collaboration context')
+    .option('--channel <channelId>', 'Bind resumed session to a collaboration channel')
+    .option('--scene <sceneId>', 'Channel-local active scene override')
+    .option('--spec <specId>', 'Channel-local active spec override')
+    .option('--doc <docId>', 'Channel-local active doc override')
     .option('--json', 'Output as JSON')
     .action(async (sessionRef, options) => {
       try {
@@ -57,7 +69,8 @@ function registerSessionCommands(program) {
         const resumed = await store.resumeSession(sessionRef || 'latest', {
           status: options.status,
         });
-        _printSessionResult('session_resume', resumed, options.json);
+        const metadata = await _maybeBindProjectChannel(store, resumed.session_id, options);
+        _printSessionResult('session_resume', resumed, options.json, metadata);
       } catch (error) {
         _exitWithError(error, options.json);
       }
@@ -97,15 +110,19 @@ function registerSessionCommands(program) {
   session
     .command('show [sessionRef]')
     .description('Show a session by id, or latest by default')
+    .option('--project-id <projectId>', 'Also resolve the project/channel snapshot')
+    .option('--channel <channelId>', 'Project channel id for channel-scoped recovery')
     .option('--json', 'Output as JSON')
     .action(async (sessionRef, options) => {
       try {
         const store = new SessionStore(process.cwd());
         const current = await store.getSession(sessionRef || 'latest');
         const sceneIndex = await store.getSceneIndexDiagnostics();
+        const projectChannel = await _maybeResolveProjectChannel(store, options);
         _printSessionResult('session_show', current, options.json, {
           session_source: 'file',
-          scene_index: sceneIndex
+          scene_index: sceneIndex,
+          ...projectChannel
         });
       } catch (error) {
         _exitWithError(error, options.json);
@@ -179,6 +196,9 @@ function _printSessionResult(action, session, asJson = false, metadata = {}) {
   if (metadata.scene_index && metadata.scene_index.status) {
     console.log(chalk.gray(`Scene index consistency: ${metadata.scene_index.status}`));
   }
+  if (metadata.project_channel && metadata.project_channel.project_id) {
+    console.log(chalk.gray(`Project channel: ${metadata.project_channel.project_id} / ${metadata.project_channel.channel_id || metadata.project_channel.focused_channel_id || 'n/a'}`));
+  }
 }
 
 function _printSessionListResult(action, sessions, asJson = false, metadata = {}) {
@@ -219,6 +239,57 @@ function _exitWithError(error, asJson = false) {
   process.exit(1);
 }
 
+async function _maybeBindProjectChannel(store, sessionId, options = {}) {
+  const projectId = `${options.projectId || ''}`.trim();
+  const channelId = `${options.channel || ''}`.trim();
+  if (!projectId || !channelId) {
+    return {};
+  }
+
+  const bound = await store.bindSessionToProjectChannel(sessionId, {
+    projectId,
+    channelId,
+    activeScene: options.scene,
+    activeSpecId: options.spec,
+    activeDoc: options.doc,
+    focus: true,
+    syncCurrentContext: true
+  });
+
+  return {
+    project_channel: buildProjectChannelOutput({
+      projectId,
+      canonicalProjectId: projectId,
+      requestedChannelId: channelId,
+      storageMode: 'split',
+      context: bound.context,
+      channel: bound.channel
+    })
+  };
+}
+
+async function _maybeResolveProjectChannel(store, options = {}) {
+  const projectId = `${options.projectId || ''}`.trim();
+  if (!projectId) {
+    return {};
+  }
+
+  const resolved = await store.getProjectChannelSession(projectId, options.channel || null);
+  return {
+    project_channel: buildProjectChannelOutput({
+      projectId,
+      canonicalProjectId: projectId,
+      requestedChannelId: options.channel || null,
+      storageMode: resolved.storageMode,
+      contextAvailable: resolved.contextAvailable,
+      context: resolved.context,
+      channel: resolved.channel,
+      session: resolved.session,
+      resolvedChannelId: resolved.resolvedChannelId
+    })
+  };
+}
+
 module.exports = {
   registerSessionCommands,
 };

package/lib/commands/spec-bootstrap.js

@@ -30,6 +30,8 @@ async function runSpecBootstrap(options = {}, dependencies = {}) {
     return bindMultiSpecSceneSession({
       specTargets,
       sceneId: options.scene,
+      projectId: options.projectId,
+      collabChannel: options.collabChannel,
       commandName: 'spec-bootstrap',
       commandLabel: 'Multi-spec bootstrap',
       commandOptions: options,
@@ -75,6 +77,8 @@ async function runSpecBootstrap(options = {}, dependencies = {}) {
 
   const sceneBinding = await resolveSpecSceneBinding({
     sceneId: options.scene,
+    projectId: options.projectId,
+    collabChannel: options.collabChannel,
     allowNoScene: false
   }, {
     projectPath,
@@ -169,7 +173,10 @@ async function runSpecBootstrap(options = {}, dependencies = {}) {
         }
         : {
           bound: false
-        }
+        },
+      ...(sceneBinding && sceneBinding.project_channel
+        ? { project_channel: sceneBinding.project_channel }
+        : {})
     };
 
     if (specSession) {
@@ -213,6 +220,8 @@ function registerSpecBootstrapCommand(program) {
     .option('--template <template-id>', 'Template hint for draft generation')
     .option('--profile <profile-id>', 'Profile for default generation strategy')
     .option('--scene <scene-id>', 'Bind this spec bootstrap as a child session of an active scene')
+    .option('--project-id <project-id>', 'Recover scene binding from one project-local collaboration context')
+    .option('--collab-channel <channel-id>', 'Recover scene binding from one collaboration channel')
     .option('--non-interactive', 'Disable prompts and use arguments/defaults only')
     .option('--dry-run', 'Preview generation result without writing files')
     .option('--json', 'Output machine-readable JSON')

package/lib/commands/spec-gate.js

@@ -32,6 +32,8 @@ async function runSpecGate(options = {}, dependencies = {}) {
     return bindMultiSpecSceneSession({
       specTargets,
       sceneId: options.scene,
+      projectId: options.projectId,
+      collabChannel: options.collabChannel,
       commandName: 'spec-gate',
       commandLabel: 'Multi-spec gate',
       commandOptions: options,
@@ -59,6 +61,8 @@ async function runSpecGate(options = {}, dependencies = {}) {
 
   const sceneBinding = await resolveSpecSceneBinding({
     sceneId: options.scene,
+    projectId: options.projectId,
+    collabChannel: options.collabChannel,
     allowNoScene: false
   }, {
     projectPath,
@@ -127,7 +131,10 @@ async function runSpecGate(options = {}, dependencies = {}) {
         scene_session_id: sceneBinding.scene_session_id,
         spec_session_id: specSession.session_id,
         binding_source: sceneBinding.source
-      }
+      },
+      ...(sceneBinding.project_channel
+        ? { project_channel: sceneBinding.project_channel }
+        : {})
     };
   } catch (error) {
     await sessionStore.completeSpecSession({
@@ -215,6 +222,8 @@ function registerSpecGateCommand(program) {
     .option('--spec <name>', 'Single Spec identifier')
     .option('--specs <names>', 'Comma-separated Spec identifiers (multi-spec defaults to orchestrate mode)')
     .option('--scene <scene-id>', 'Bind this spec gate run as a child session of an active scene')
+    .option('--project-id <project-id>', 'Recover scene binding from one project-local collaboration context')
+    .option('--collab-channel <channel-id>', 'Recover scene binding from one collaboration channel')
     .option('--policy <path>', 'Policy JSON path')
     .option('--strict', 'Enable strict mode override')
     .option('--json', 'Output machine-readable JSON')

package/lib/commands/spec-pipeline.js

@@ -29,6 +29,8 @@ async function runSpecPipeline(options = {}, dependencies = {}) {
     return bindMultiSpecSceneSession({
       specTargets,
       sceneId: options.scene,
+      projectId: options.projectId,
+      collabChannel: options.collabChannel,
       commandName: 'spec-pipeline',
       commandLabel: 'Multi-spec pipeline',
       commandOptions: options,
@@ -56,6 +58,8 @@ async function runSpecPipeline(options = {}, dependencies = {}) {
 
   const sceneBinding = await resolveSpecSceneBinding({
     sceneId: options.scene,
+    projectId: options.projectId,
+    collabChannel: options.collabChannel,
     allowNoScene: false
   }, {
     projectPath,
@@ -150,7 +154,10 @@ async function runSpecPipeline(options = {}, dependencies = {}) {
       }
       : {
         bound: false
-      }
+      },
+    ...(sceneBinding && sceneBinding.project_channel
+      ? { project_channel: sceneBinding.project_channel }
+      : {})
   };
 
   if (specSession) {
@@ -199,6 +206,8 @@ function registerSpecPipelineCommand(program) {
     .option('--spec <name>', 'Single Spec identifier')
     .option('--specs <names>', 'Comma-separated Spec identifiers (multi-spec defaults to orchestrate mode)')
     .option('--scene <scene-id>', 'Bind this spec pipeline run as a child session of an active scene')
+    .option('--project-id <project-id>', 'Recover scene binding from one project-local collaboration context')
+    .option('--collab-channel <channel-id>', 'Recover scene binding from one collaboration channel')
     .option('--from-stage <stage>', 'Start stage (requirements/design/tasks/gate)')
     .option('--to-stage <stage>', 'End stage (requirements/design/tasks/gate)')
     .option('--resume', 'Resume from latest unfinished stage state')