@aerovato/operator-helper 1.7.1 → 1.9.0

package/README.md

@@ -4,7 +4,7 @@ Operator Memory: Durable context for agent-driven development.
 
 Operator Helper installs and manages Operator Memory, an agent-driven development framework that turns agent work into lasting project knowledge through continuous documentation.
 
-## Install
+### Install
 
 Operator Helper requires Node.js 20 or newer.
 
@@ -21,22 +21,27 @@ bun add --global --minimum-release-age 0 @aerovato/operator-helper@latest
 Install an adapter:
 
 ```sh
-# OpenCode 2
-operator-helper install opencode-v2
+# OpenCode (V2)
+operator-helper install opencode
 
 # OpenCode 1 (legacy)
-operator-helper install opencode
+operator-helper install opencode-v1
 
 # Pi
 operator-helper install pi
 
 # DeepSeek Harness
 operator-helper install deepseek
+
+# Kiro
+operator-helper install kiro
 ```
 
+OpenCode defaults to V2; `install opencode-v1` is the explicit legacy route. Existing plugin registrations are not migrated automatically.
+
 Restart the harness, then run `/operator:user-init` in a new conversation to begin setup.
 
-## Usage
+### Usage
 
 Users interact with Operator through the harness commands `/operator:user-init`, `/operator:project-init`, `/operator:index`, and `/operator:repair`. These commands guide the working agent, which uses Operator Helper for setup, status, validation, and repair mechanics.
 
@@ -46,17 +51,18 @@ The direct user-facing Helper operation is adapter installation:
 
 ```sh
 operator-helper install opencode
-operator-helper install opencode-v2
+operator-helper install opencode-v1
 operator-helper install pi
 operator-helper install deepseek
+operator-helper install kiro
 ```
 
 Operator Helper automatically checks for and installs updates when commands run. If it cannot determine whether Bun or npm owns the global installation, it asks for a manual update using the original installation method.
 
-## Documentation
+### Documentation
 
 - [Overview and setup](https://github.com/aerovato/operator-memory#readme)
-- [Workflow](https://github.com/aerovato/operator-memory/blob/main/docs/workflow.md)
+- [Getting Started](https://github.com/aerovato/operator-memory/blob/main/docs/getting-started.md)
 - [Architecture](https://github.com/aerovato/operator-memory/blob/main/docs/architecture.md)
 - [Troubleshooting](https://github.com/aerovato/operator-memory/blob/main/docs/troubleshooting.md)
 

package/dist/index.js

@@ -15319,7 +15319,7 @@ var log = (...args) => consoleWith((console2) => sync(() => {
 // package.json
 var package_default = {
   name: "@aerovato/operator-helper",
-  version: "1.7.1",
+  version: "1.9.0",
   description: "Installation and setup CLI for Operator Memory",
   license: "BSD-3-Clause",
   author: "Aerovato Research",
@@ -15882,17 +15882,20 @@ operator-helper install claude-code
 # Install Codex plugin
 operator-helper install codex
 
-# Install OpenCode V2 plugin
-operator-helper install opencode-v2
-
 # Install OpenCode plugin
 operator-helper install opencode
 
+# Install legacy OpenCode V1 plugin
+operator-helper install opencode-v1
+
 # Install Pi plugin
 operator-helper install pi
 
 # Install DeepSeek Harness plugin
 operator-helper install deepseek
+
+# Install Kiro adapter
+operator-helper install kiro
 \`\`\`
 `;
 
@@ -16674,6 +16677,136 @@ function profileResult(profile, result) {
   return { exitCode: 0, output: `✓ ${label}: ${result.output || "Plugin installed"}` };
 }
 
+// src/commands/install/kiro.ts
+import { mkdir as mkdir3, writeFile as writeFile4 } from "node:fs/promises";
+import { dirname as dirname2, join as join3 } from "node:path";
+
+// src/templates/kiro.ts
+var HOOK = `${JSON.stringify({
+  version: "v1",
+  hooks: [
+    {
+      name: "Operator Memory preamble",
+      trigger: "SessionStart",
+      action: { type: "command", command: "operator-helper preamble" },
+      timeout: 120,
+      enabled: true
+    }
+  ]
+}, null, 2)}
+`;
+var STEERING = `---
+inclusion: always
+---
+
+# Operator Memory
+
+Operator Memory is installed for Kiro. If you do not see Operator's preamble guidance above wrapped within \`<operator-guidance>\`, manually run the \`operator-helper preamble\` command once from the workspace root and follow all instructions from the command output. If the command fails, report to the user and stop. Do not run if the preamble is already available.
+`;
+var RECOVERY = (command) => `## Recovery
+
+- If Helper cannot start, install or repair the npm package \`@aerovato/operator-helper\` globally and retry the failed command.
+- If the version check or upgrade fails, diagnose the error and retry.
+- If \`operator-helper ${command}\` reports a failure, use its output to resolve it and rerun it as needed.
+- If you cannot resolve a problem, report the blocker.
+
+Use Helper output as working context. Do not reproduce it wholesale or reimplement Helper logic.
+`;
+var USER_INIT = `---
+name: operator-user-init
+description: Initialize and configure the Operator User Partition. Use only when the user invokes /operator-user-init.
+---
+
+# Operator User Setup
+
+1. Run \`operator-helper version\`. If an update is available, run \`operator-helper upgrade\` before continuing.
+2. Run \`operator-helper user init\` and follow the emitted User Setup guide, including when initialization reports failures.
+
+${RECOVERY("user init")}`;
+var PROJECT_INIT = `---
+name: operator-project-init
+description: Initialize and configure the Operator Project Brain. Use only when the user invokes /operator-project-init.
+---
+
+# Operator Project Setup
+
+1. Run \`operator-helper version\`. If an update is available, run \`operator-helper upgrade\` before continuing.
+2. Run \`operator-helper project init\` and follow the emitted Project Setup guide, including when initialization reports failures.
+
+For a new conversation to set up the Project Index, tell the user to invoke \`/operator-index\`.
+
+${RECOVERY("project init")}`;
+var INDEX = `---
+name: operator-index
+description: Build or refresh the Operator Project Index. Use only when the user invokes /operator-index.
+---
+
+# Operator Project Index Setup
+
+1. Run \`operator-helper version\`. If an update is available, run \`operator-helper upgrade\` before continuing.
+2. Run \`operator-helper index init\` and follow the emitted Project Index Setup guide, including when inspection reports failures.
+
+If the Project Brain is missing, tell the user to invoke \`/operator-project-init\` to set it up.
+
+${RECOVERY("index init")}`;
+var REPAIR = `---
+name: operator-repair
+description: Diagnose and repair Operator memory load failures. Use only when the user invokes /operator-repair.
+---
+
+# Operator Memory Repair
+
+1. Run \`operator-helper version\`. If an update is available, run \`operator-helper upgrade\` before continuing.
+2. Run \`operator-helper memory check\`. If no issues are detected, stop. Otherwise, repair only the reported load failures without initializing absent partitions. Rerun \`operator-helper memory check\` to confirm the repair, then read the applicable Operator memory documents.
+
+If \`~/.kiro/hooks/operator-memory.json\` or \`~/.kiro/steering/operator-memory.md\` is missing, tell the user to run \`operator-helper install kiro\` and start a new session.
+
+${RECOVERY("memory check")}`;
+var KIRO_FILES = [
+  { path: "hooks/operator-memory.json", content: HOOK },
+  { path: "steering/operator-memory.md", content: STEERING },
+  { path: "skills/operator-user-init/SKILL.md", content: USER_INIT },
+  { path: "skills/operator-project-init/SKILL.md", content: PROJECT_INIT },
+  { path: "skills/operator-index/SKILL.md", content: INDEX },
+  { path: "skills/operator-repair/SKILL.md", content: REPAIR }
+];
+
+// src/commands/install/kiro.ts
+var installKiro = fn2("installKiro")(function* (context) {
+  const helper = yield* runProcess("operator-helper", ["help"], context.cwd, null);
+  if (!helper.ok) {
+    return { exitCode: 1, output: `✗ Operator Helper must be available on PATH: ${helper.error}` };
+  }
+  if (helper.exitCode !== 0) {
+    return {
+      exitCode: helper.exitCode,
+      output: helper.output || "Operator Helper must be available on PATH"
+    };
+  }
+  return yield* writeKiroFiles(join3(context.home, ".kiro"));
+});
+function writeKiroFiles(kiroHome) {
+  return promise2(async () => {
+    try {
+      for (const file of KIRO_FILES) {
+        const path = join3(kiroHome, file.path);
+        await mkdir3(dirname2(path), { recursive: true });
+        await writeFile4(path, file.content);
+      }
+    } catch (error) {
+      return {
+        exitCode: 1,
+        output: `✗ Could not install the Kiro adapter: ${getErrorMessage(error)}`
+      };
+    }
+    return {
+      exitCode: 0,
+      output: `✓ Kiro adapter installed in ${kiroHome}
+Start a new Kiro session.`
+    };
+  });
+}
+
 // src/commands/install/opencode.ts
 var OPENCODE_PLUGIN = "@aerovato/operator-opencode@latest";
 var installOpenCode = fn2("installOpenCode")(function* (context) {
@@ -16730,7 +16863,7 @@ var installPi = fn2("installPi")(function* (context) {
 import { resolve as resolve2 } from "node:path";
 
 // ../core/src/memory/project.ts
-import { extname, join as join3, relative, sep } from "node:path";
+import { extname, join as join4, relative, sep } from "node:path";
 
 // ../core/src/utils.ts
 function success(value) {
@@ -16844,13 +16977,13 @@ async function loadProjectPartition(root, loadFiles) {
     return hasNodeErrorCode(directory.error.cause, "ENOENT") ? success(loadFiles ? { exists: false, operatorInstructions: null, catalog: null, indexes: [] } : { exists: false }) : directory;
   }
   if (!loadFiles) {
-    for (const path of [join3(root, "operator.md"), join3(root, "catalog.md")]) {
+    for (const path of [join4(root, "operator.md"), join4(root, "catalog.md")]) {
       const file = await checkOptionalReadableFile(path);
       if (!file.ok) {
         return file;
       }
     }
-    const indexRoot = join3(root, "index");
+    const indexRoot = join4(root, "index");
     const indexPaths = await listMarkdownFiles(indexRoot, indexRoot);
     if (!indexPaths.ok) {
       return indexPaths;
@@ -16863,15 +16996,15 @@ async function loadProjectPartition(root, loadFiles) {
     }
     return success({ exists: true });
   }
-  const operatorInstructions = await readOptionalContent(join3(root, "operator.md"));
+  const operatorInstructions = await readOptionalContent(join4(root, "operator.md"));
   if (!operatorInstructions.ok) {
     return operatorInstructions;
   }
-  const catalog = await readOptionalContent(join3(root, "catalog.md"));
+  const catalog = await readOptionalContent(join4(root, "catalog.md"));
   if (!catalog.ok) {
     return catalog;
   }
-  const indexes = await readIndexes(join3(root, "index"));
+  const indexes = await readIndexes(join4(root, "index"));
   if (!indexes.ok) {
     return indexes;
   }
@@ -16909,7 +17042,7 @@ async function listMarkdownFiles(root, directory) {
   }
   const paths = [];
   for (const entry of entries.value) {
-    const path = join3(directory, entry.name);
+    const path = join4(directory, entry.name);
     if (entry.isDirectory()) {
       const nestedPaths = await listMarkdownFiles(root, path);
       if (!nestedPaths.ok) {
@@ -16930,14 +17063,14 @@ function compareStrings2(left, right) {
 }
 
 // ../core/src/memory/user.ts
-import { join as join4 } from "node:path";
+import { join as join5 } from "node:path";
 async function loadUserPartition(root, loadFiles) {
   if (!loadFiles) {
     const directory = await readDirectory2(root);
     if (!directory.ok) {
       return hasNodeErrorCode(directory.error.cause, "ENOENT") ? success({ exists: false }) : directory;
     }
-    for (const path of [join4(root, "operator.md"), join4(root, "catalog.md")]) {
+    for (const path of [join5(root, "operator.md"), join5(root, "catalog.md")]) {
       const file = await checkOptionalReadableFile(path);
       if (!file.ok) {
         return file;
@@ -16945,11 +17078,11 @@ async function loadUserPartition(root, loadFiles) {
     }
     return success({ exists: true });
   }
-  const operatorInstructions = await readOptionalContent(join4(root, "operator.md"));
+  const operatorInstructions = await readOptionalContent(join5(root, "operator.md"));
   if (!operatorInstructions.ok) {
     return operatorInstructions;
   }
-  const catalog = await readOptionalContent(join4(root, "catalog.md"));
+  const catalog = await readOptionalContent(join5(root, "catalog.md"));
   if (!catalog.ok) {
     return catalog;
   }
@@ -17904,11 +18037,12 @@ ${renderTable([
   ["version", "Show the installed version and check for updates"],
   ["upgrade", "Update Operator Helper to the latest release"],
   ["install codex", "Install or update the Codex plugin"],
-  ["install opencode", "Install or update the OpenCode plugin"],
-  ["install opencode-v2", "Install or update the OpenCode V2 plugin"],
+  ["install opencode", "Install or update the OpenCode plugin (V2)"],
+  ["install opencode-v1", "Install or update the legacy OpenCode V1 plugin"],
   ["install deepseek", "Install or update the DeepSeek Harness plugin"],
   ["install pi", "Install or update the Pi plugin"],
-  ["install claude-code", "Install or update the Claude Code plugin"]
+  ["install claude-code", "Install or update the Claude Code plugin"],
+  ["install kiro", "Install or update the Kiro adapter"]
 ])}
 
 AGENT COMMANDS
@@ -17962,13 +18096,16 @@ function runCli(arguments_, context) {
       case "install claude-code":
         return yield* installClaudeCode(context);
       case "install opencode":
-        return yield* installOpenCode(context);
       case "install opencode-v2":
         return yield* installOpenCodeV2(context);
+      case "install opencode-v1":
+        return yield* installOpenCode(context);
       case "install deepseek":
         return yield* installDeepSeek(context);
       case "install pi":
         return yield* installPi(context);
+      case "install kiro":
+        return yield* installKiro(context);
       case "user guide":
       case "project guide":
       case "index guide":
@@ -18007,4 +18144,4 @@ var main = gen2(function* () {
 }).pipe(provide4(LiveLayers));
 runMain2(main);
 
-//# debugId=BD7F91EF8CB96E6A64756E2164756E21
+//# debugId=EFA6C78B3DF809B164756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aerovato/operator-helper",
-  "version": "1.7.1",
+  "version": "1.9.0",
   "description": "Installation and setup CLI for Operator Memory",
   "license": "BSD-3-Clause",
   "author": "Aerovato Research",