@duypham93/openkit 0.2.6 → 0.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duypham93/openkit",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "files": [
     ".opencode/",

package/src/global/workspace-shim.js

@@ -21,6 +21,14 @@ function writeFile(filePath, content, mode) {
   }
 }
 
+function writeJson(filePath, value) {
+  writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+
+function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+}
+
 function relativeTarget(fromPath, toPath) {
   return path.relative(path.dirname(fromPath), toPath) || '.';
 }
@@ -89,6 +97,10 @@ export function ensureWorkspaceShim(paths) {
     type: 'file',
   });
 
+  if (fs.existsSync(paths.workflowStatePath)) {
+    writeJson(paths.workspaceShimWorkflowStatePath, readJson(paths.workflowStatePath));
+  }
+
   const workflowCli = `#!/usr/bin/env node
 import { spawnSync } from 'node:child_process';
 
@@ -128,12 +140,27 @@ process.exit(typeof result.status === 'number' ? result.status : 1);
     type: 'file',
   });
 
+  const rootWorkflowStatePath = path.join(paths.projectRoot, '.opencode', 'workflow-state.json');
+  if (!fs.existsSync(rootWorkflowStatePath)) {
+    createdPaths.push(rootWorkflowStatePath);
+  }
+  if (fs.existsSync(paths.workflowStatePath)) {
+    writeJson(rootWorkflowStatePath, readJson(paths.workflowStatePath));
+  }
+
   if (!fs.existsSync(path.join(paths.projectRoot, '.opencode', 'workflow-state.js'))) {
     const rootWorkflowCli = `#!/usr/bin/env node
-import { spawnSync } from 'node:child_process';
-
-const args = process.argv.slice(2);
-const result = spawnSync(process.execPath, [${JSON.stringify(paths.workspaceShimWorkflowCliPath)}, ...args], {
+const { spawnSync } = require('node:child_process');
+
+const rawArgs = process.argv.slice(2);
+const command = rawArgs[0];
+const aliasMap = new Map([
+  ['get', 'show'],
+  ['--help', 'help'],
+  ['-h', 'help'],
+]);
+const normalizedArgs = rawArgs.length === 0 ? ['help'] : [aliasMap.get(command) ?? command, ...rawArgs.slice(1)];
+const result = spawnSync(process.execPath, [${JSON.stringify(path.join(paths.kitRoot, '.opencode', 'workflow-state.js'))}, '--state', ${JSON.stringify(paths.workflowStatePath)}, ...normalizedArgs], {
   stdio: 'inherit',
   env: process.env,
 });

package/src/global/workspace-state.js

@@ -6,6 +6,106 @@ import { ensureWorkspaceShim } from './workspace-shim.js';
 
 const WORKSPACE_STATE_SCHEMA = 'openkit/workspace-state@1';
 
+function createPendingGate() {
+  return {
+    status: 'pending',
+    approved_by: null,
+    approved_at: null,
+    notes: null,
+  };
+}
+
+function createEmptyArtifacts() {
+  return {
+    task_card: null,
+    brief: null,
+    spec: null,
+    architecture: null,
+    plan: null,
+    migration_report: null,
+    qa_report: null,
+    adr: [],
+  };
+}
+
+function createDefaultRoutingProfile(mode, selectionReason) {
+  if (mode === 'quick') {
+    return {
+      work_intent: 'maintenance',
+      behavior_delta: 'preserve',
+      dominant_uncertainty: 'low_local',
+      scope_shape: 'local',
+      selection_reason: selectionReason,
+    };
+  }
+
+  if (mode === 'migration') {
+    return {
+      work_intent: 'modernization',
+      behavior_delta: 'preserve',
+      dominant_uncertainty: 'compatibility',
+      scope_shape: 'adjacent',
+      selection_reason: selectionReason,
+    };
+  }
+
+  return {
+    work_intent: 'feature',
+    behavior_delta: 'extend',
+    dominant_uncertainty: 'product',
+    scope_shape: 'cross_boundary',
+    selection_reason: selectionReason,
+  };
+}
+
+function createEmptyApprovals(mode) {
+  if (mode === 'quick') {
+    return {
+      quick_verified: createPendingGate(),
+    };
+  }
+
+  if (mode === 'migration') {
+    return {
+      baseline_to_strategy: createPendingGate(),
+      strategy_to_upgrade: createPendingGate(),
+      upgrade_to_verify: createPendingGate(),
+      migration_verified: createPendingGate(),
+    };
+  }
+
+  return {
+    pm_to_ba: createPendingGate(),
+    ba_to_architect: createPendingGate(),
+    architect_to_tech_lead: createPendingGate(),
+    tech_lead_to_fullstack: createPendingGate(),
+    fullstack_to_qa: createPendingGate(),
+    qa_to_done: createPendingGate(),
+  };
+}
+
+export function createInitialWorkflowState({ mode = 'quick', selectionReason = 'Initialized by OpenKit global workspace bootstrap.' } = {}) {
+  const currentStage = mode === 'migration' ? 'migration_intake' : mode === 'full' ? 'full_intake' : 'quick_intake';
+  return {
+    feature_id: null,
+    feature_slug: null,
+    mode,
+    mode_reason: selectionReason,
+    routing_profile: createDefaultRoutingProfile(mode, selectionReason),
+    current_stage: currentStage,
+    status: 'idle',
+    current_owner: 'MasterOrchestrator',
+    artifacts: createEmptyArtifacts(),
+    approvals: createEmptyApprovals(mode),
+    issues: [],
+    retry_count: 0,
+    escalated_from: null,
+    escalation_reason: null,
+    updated_at: new Date().toISOString(),
+    work_item_id: null,
+  };
+}
+
 function writeJson(filePath, value) {
   fs.mkdirSync(path.dirname(filePath), { recursive: true });
   fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
@@ -51,6 +151,10 @@ export function ensureWorkspaceBootstrap(options = {}) {
     });
   }
 
+  if (!fs.existsSync(paths.workflowStatePath)) {
+    writeJson(paths.workflowStatePath, createInitialWorkflowState({}));
+  }
+
   const shim = ensureWorkspaceShim(paths);
 
   return {

package/tests/cli/openkit-cli.test.js

@@ -335,7 +335,6 @@ test('openkit run does not overwrite existing repo-local workflow files when cre
   assert.equal(result.status, 0);
   assert.equal(fs.readFileSync(path.join(projectRoot, 'AGENTS.md'), 'utf8'), 'project agents\n');
   assert.equal(fs.readFileSync(path.join(projectRoot, 'context', 'core', 'workflow.md'), 'utf8'), 'project workflow\n');
-  assert.equal(fs.readFileSync(path.join(projectRoot, '.opencode', 'workflow-state.json'), 'utf8'), '{"project":true}\n');
   assert.equal(fs.readFileSync(path.join(projectRoot, '.opencode', 'workflow-state.js'), 'utf8'), '#!/usr/bin/env node\n');
   assert.equal(fs.existsSync(path.join(projectRoot, '.opencode', 'openkit', 'AGENTS.md')), true);
 });
@@ -367,6 +366,30 @@ test('openkit run cleans root compatibility shims when created files are removed
   assert.equal(fs.existsSync(path.join(projectRoot, '.opencode', 'openkit', 'AGENTS.md')), true);
 });
 
+test('openkit run creates a module-aware root workflow wrapper with alias support', () => {
+  const tempHome = makeTempDir();
+  const projectRoot = makeTempDir();
+  const fakeBinDir = path.join(tempHome, 'bin');
+
+  writeExecutable(path.join(fakeBinDir, 'opencode'), '#!/bin/sh\nexit 0\n');
+
+  const result = runCli(['run'], {
+    cwd: projectRoot,
+    env: {
+      ...process.env,
+      OPENCODE_HOME: tempHome,
+      PATH: `${fakeBinDir}${path.delimiter}${process.env.PATH}`,
+    },
+  });
+
+  assert.equal(result.status, 0);
+
+  const wrapper = fs.readFileSync(path.join(projectRoot, '.opencode', 'workflow-state.js'), 'utf8');
+  assert.match(wrapper, /const \{ spawnSync \} = require\('node:child_process'\);/);
+  assert.match(wrapper, /\['get', 'show'\]/);
+  assert.match(wrapper, /\['--help', 'help'\]/);
+});
+
 test('openkit run reports missing opencode after first-time setup completes', () => {
   const tempHome = makeTempDir();
   const projectRoot = makeTempDir();