@duypham93/openkit 0.2.4 → 0.2.5

package/commands/write-plan.md

@@ -8,9 +8,10 @@ Use `/write-plan` to create an implementation plan for work currently in `Full D
 
 ## Global OpenKit path rule
 
-- In globally installed OpenKit sessions, resolve OpenKit-owned docs and templates from `OPENKIT_KIT_ROOT` instead of assuming the target repository contains `AGENTS.md`, `context/`, `docs/templates/`, or `.opencode/`.
-- Resolve resumable workflow state from `OPENKIT_WORKFLOW_STATE`.
-- Use `node "${OPENKIT_KIT_ROOT}/.opencode/workflow-state.js" --state "${OPENKIT_WORKFLOW_STATE}" <command>` for workflow-state checks in global mode.
+- In globally installed OpenKit sessions, treat `.opencode/openkit/` as the repo-local compatibility surface for OpenKit-owned docs, templates, and workflow tools.
+- Read canonical OpenKit docs from `.opencode/openkit/...`, not from repo-root `context/`, repo-root `AGENTS.md`, or repo-root `.opencode/`.
+- Use `.opencode/openkit/workflow-state.json` for resumable workflow state.
+- Use `node .opencode/openkit/workflow-state.js <command>` for workflow-state checks in global mode.
 
 ## Preconditions
 
@@ -21,13 +22,13 @@ Use `/write-plan` to create an implementation plan for work currently in `Full D
 
 ## Canonical docs to load
 
-- `AGENTS.md`
-- `context/navigation.md`
-- `context/core/workflow.md`
-- `context/core/project-config.md`
-- `.opencode/workflow-state.json`
-- `docs/templates/implementation-plan-template.md`
-- `docs/templates/migration-report-template.md` when migration work benefits from one running artifact
+- `.opencode/openkit/AGENTS.md`
+- `.opencode/openkit/context/navigation.md`
+- `.opencode/openkit/context/core/workflow.md`
+- `.opencode/openkit/context/core/project-config.md`
+- `.opencode/openkit/workflow-state.json`
+- `.opencode/openkit/docs/templates/implementation-plan-template.md`
+- `.opencode/openkit/docs/templates/migration-report-template.md` when migration work benefits from one running artifact
 - skill `writing-plans`
 
 For operator checks, use the current workflow-state utility surface: `status`, `doctor`, `show`, and `validate`.
@@ -53,4 +54,4 @@ For operator checks, use the current workflow-state utility surface: `status`, `
 - The plan should name the strongest real validation path available in the repository
 - In migration mode, use `migration_report` when handoffs would benefit from a single running narrative instead of scattered notes
 - If no repo-native app build, lint, or test command exists, say that explicitly in the plan instead of guessing a stack command
-- Use the workflow-state utility against `OPENKIT_WORKFLOW_STATE` only to confirm workflow state, not to stand in for implementation verification
+- Use `node .opencode/openkit/workflow-state.js validate` only to confirm workflow state, not to stand in for implementation verification

package/package.json

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

package/src/global/paths.js

@@ -82,5 +82,11 @@ export function getWorkspacePaths({ projectRoot, env = process.env, platform = p
     legacyRuntimeDir: path.join(resolvedProjectRoot, '.opencode'),
     legacyWorkflowStatePath: path.join(resolvedProjectRoot, '.opencode', 'workflow-state.json'),
     legacyWorkItemsDir: path.join(resolvedProjectRoot, '.opencode', 'work-items'),
+    workspaceShimDir: path.join(resolvedProjectRoot, '.opencode', 'openkit'),
+    workspaceShimContextDir: path.join(resolvedProjectRoot, '.opencode', 'openkit', 'context'),
+    workspaceShimTemplatesDir: path.join(resolvedProjectRoot, '.opencode', 'openkit', 'docs', 'templates'),
+    workspaceShimAgentsPath: path.join(resolvedProjectRoot, '.opencode', 'openkit', 'AGENTS.md'),
+    workspaceShimWorkflowStatePath: path.join(resolvedProjectRoot, '.opencode', 'openkit', 'workflow-state.json'),
+    workspaceShimWorkflowCliPath: path.join(resolvedProjectRoot, '.opencode', 'openkit', 'workflow-state.js'),
   };
 }

package/src/global/workspace-shim.js

@@ -0,0 +1,104 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+function ensureParent(filePath) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
+
+function writeFile(filePath, content, mode) {
+  ensureParent(filePath);
+  fs.writeFileSync(filePath, content, 'utf8');
+  if (typeof mode === 'number') {
+    fs.chmodSync(filePath, mode);
+  }
+}
+
+function relativeTarget(fromPath, toPath) {
+  return path.relative(path.dirname(fromPath), toPath) || '.';
+}
+
+function createSymlinkOrCopy({ linkPath, targetPath, type = 'file' }) {
+  ensureParent(linkPath);
+
+  try {
+    if (fs.existsSync(linkPath) || fs.lstatSync(linkPath)) {
+      fs.rmSync(linkPath, { recursive: true, force: true });
+    }
+  } catch {
+    // ignore cleanup misses
+  }
+
+  try {
+    fs.symlinkSync(relativeTarget(linkPath, targetPath), linkPath, type);
+    return 'symlink';
+  } catch {
+    const stats = fs.statSync(targetPath);
+    if (stats.isDirectory()) {
+      fs.cpSync(targetPath, linkPath, { recursive: true });
+    } else {
+      fs.copyFileSync(targetPath, linkPath);
+    }
+    return 'copy';
+  }
+}
+
+export function ensureWorkspaceShim(paths) {
+  fs.mkdirSync(paths.workspaceShimDir, { recursive: true });
+
+  createSymlinkOrCopy({
+    linkPath: paths.workspaceShimAgentsPath,
+    targetPath: path.join(paths.kitRoot, 'AGENTS.md'),
+    type: 'file',
+  });
+
+  createSymlinkOrCopy({
+    linkPath: paths.workspaceShimContextDir,
+    targetPath: path.join(paths.kitRoot, 'context'),
+    type: 'dir',
+  });
+
+  createSymlinkOrCopy({
+    linkPath: paths.workspaceShimTemplatesDir,
+    targetPath: path.join(paths.kitRoot, 'docs', 'templates'),
+    type: 'dir',
+  });
+
+  createSymlinkOrCopy({
+    linkPath: paths.workspaceShimWorkflowStatePath,
+    targetPath: paths.workflowStatePath,
+    type: 'file',
+  });
+
+  const workflowCli = `#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+
+const args = process.argv.slice(2);
+const result = spawnSync(process.execPath, [${JSON.stringify(path.join(paths.kitRoot, '.opencode', 'workflow-state.js'))}, '--state', ${JSON.stringify(paths.workflowStatePath)}, ...args], {
+  stdio: 'inherit',
+  env: process.env,
+});
+
+if (result.error) {
+  throw result.error;
+}
+
+process.exit(typeof result.status === 'number' ? result.status : 1);
+`;
+
+  writeFile(paths.workspaceShimWorkflowCliPath, workflowCli, 0o755);
+
+  const gitDir = path.join(paths.projectRoot, '.git');
+  if (fs.existsSync(gitDir)) {
+    const excludePath = path.join(gitDir, 'info', 'exclude');
+    const entry = '.opencode/openkit/';
+    let current = '';
+    if (fs.existsSync(excludePath)) {
+      current = fs.readFileSync(excludePath, 'utf8');
+    }
+    if (!current.split(/\r?\n/).includes(entry)) {
+      writeFile(excludePath, `${current}${current.endsWith('\n') || current.length === 0 ? '' : '\n'}${entry}\n`);
+    }
+  }
+
+  return paths;
+}

package/src/global/workspace-state.js

@@ -2,6 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 
 import { getWorkspacePaths } from './paths.js';
+import { ensureWorkspaceShim } from './workspace-shim.js';
 
 const WORKSPACE_STATE_SCHEMA = 'openkit/workspace-state@1';
 
@@ -50,6 +51,8 @@ export function ensureWorkspaceBootstrap(options = {}) {
     });
   }
 
+  ensureWorkspaceShim(paths);
+
   return paths;
 }
 

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

@@ -222,6 +222,10 @@ process.stdout.write('mock opencode launched\\n');
   assert.equal(invocation.configDir, path.join(tempHome, 'kits', 'openkit'));
   assert.match(invocation.workflowState, /workspaces\/.*\/openkit\/\.opencode\/workflow-state\.json$/);
   assert.equal(invocation.kitRoot, path.join(tempHome, 'kits', 'openkit'));
+  assert.equal(fs.existsSync(path.join(projectRoot, '.opencode', 'openkit', 'AGENTS.md')), true);
+  assert.equal(fs.existsSync(path.join(projectRoot, '.opencode', 'openkit', 'context', 'core', 'workflow.md')), true);
+  assert.equal(fs.lstatSync(path.join(projectRoot, '.opencode', 'openkit', 'workflow-state.json')).isSymbolicLink() || fs.existsSync(path.join(projectRoot, '.opencode', 'openkit', 'workflow-state.json')), true);
+  assert.equal(fs.existsSync(path.join(projectRoot, '.opencode', 'openkit', 'workflow-state.js')), true);
 });
 
 test('openkit run does not reinstall when the global install already exists', () => {
@@ -294,6 +298,7 @@ process.stdout.write('mock opencode launched after auto-install\\n');
   const invocation = readJson(logPath);
   assert.deepEqual(invocation.argv, [projectRoot]);
   assert.equal(invocation.kitRoot, path.join(tempHome, 'kits', 'openkit'));
+  assert.equal(fs.existsSync(path.join(projectRoot, '.opencode', 'openkit', 'AGENTS.md')), true);
 });
 
 test('openkit run reports missing opencode after first-time setup completes', () => {