@mstar-harness/opencode 0.6.14 → 0.6.15

package/dist/mstar.js

@@ -7,6 +7,7 @@ var __dirname2 = path.dirname(fileURLToPath(import.meta.url));
 var packageRoot = path.resolve(__dirname2, "..");
 var bundledSkillsDir = path.join(packageRoot, "harness-skills");
 var bundledAgentsDir = path.join(packageRoot, "harness-agents");
+var bundledCommandsDir = path.join(packageRoot, "harness-commands");
 var bootstrapAgentsPath = path.join(packageRoot, "AGENTS.md");
 var BOOTSTRAP_MARKER = "IMPORTANT_FOR_HARNESS";
 function resolveSkillPathCandidates() {
@@ -121,6 +122,33 @@ var loadAgentsFromDir = (agentsDirPath) => {
   return result;
 };
 var loadBundledAgents = () => loadAgentsFromDir(bundledAgentsDir);
+var loadBundledCommands = () => {
+  if (!fs.existsSync(bundledCommandsDir))
+    return {};
+  const files = fs.readdirSync(bundledCommandsDir).filter((name) => /\.(?:md|mdc|markdown|txt)$/.test(name)).sort((a, b) => a.localeCompare(b));
+  const result = {};
+  for (const file of files) {
+    const filePath = path.join(bundledCommandsDir, file);
+    const content = fs.readFileSync(filePath, "utf8");
+    const { frontmatter, body } = extractFrontmatterAndBody(content);
+    const parsed = parseSimpleFrontmatter(frontmatter);
+    const parsedName = typeof parsed.name === "string" ? parsed.name : file.replace(/\.(?:md|mdc|markdown|txt)$/, "");
+    const commandDef = {
+      template: body.trim()
+    };
+    if (typeof parsed.description === "string") {
+      commandDef.description = parsed.description;
+    }
+    if (typeof parsed.agent === "string") {
+      commandDef.agent = parsed.agent;
+    }
+    if (typeof parsed.model === "string") {
+      commandDef.model = parsed.model;
+    }
+    result[parsedName] = commandDef;
+  }
+  return result;
+};
 var MorningStarHarnessPlugin = async () => {
   const homeDir = os.homedir();
   const envConfigDir = normalizePath(process.env.OPENCODE_CONFIG_DIR, homeDir);
@@ -146,6 +174,14 @@ var MorningStarHarnessPlugin = async () => {
           ...definition
         };
       }
+      const markdownCommands = loadBundledCommands();
+      runtimeConfig.command = runtimeConfig.command || {};
+      for (const [commandId, definition] of Object.entries(markdownCommands)) {
+        runtimeConfig.command[commandId] = {
+          ...runtimeConfig.command[commandId] || {},
+          ...definition
+        };
+      }
     },
     "experimental.chat.messages.transform": async (_input, output) => {
       const bootstrap = loadBootstrapContent();

package/harness-commands/iteration-start.md

@@ -0,0 +1,65 @@
+---
+name: iteration-start
+description: Start a new harness iteration — research backlog, lock direction with grill-me, produce compass/plans, run review chain (product-manager → architect → writing-specialist → PM lock), submit to integration branch
+agent: project-manager
+---
+
+# Start Iteration
+
+Start a new Morning Star harness iteration. Follow Prepare gates from `mstar-phase-gates` (specify → clarify → plan).
+
+## 1. Research
+
+Load harness entry, then survey structured and unstructured sources:
+
+**Structured harness dirs:**
+- `{HARNESS_DIR}/status.json` → active plans, deferred features, residuals
+- `{ITERATION_DIR}/` → previous iteration compasses, roadmap batches
+- `{KNOWLEDGE_DIR}/` → design knowledge, architecture notes
+- `{SPECS_DIR}/` → existing specs, gaps
+
+**Unstructured discovery — search the repo for planning artifacts by name:**
+- Glob for `**/roadmap*.md`, `**/ROADMAP*.md`, `**/*-roadmap.md`
+- Glob for `**/deferred*.md`, `**/DEFERRED*.md`
+- Glob for `**/features*.md`, `**/FEATURES*.md`
+- Also search for `**/backlog*.md`, `**/TODO*.md`, `**/todo*.md`, `**/*.plan.md`
+- Open and read any matches that carry iteration-level or deferred-scope information
+
+Identify deferred or incomplete items from prior iterations as priority candidates for this iteration.
+
+## 2. Explore Directions
+
+Explore candidate directions targeting **product completeness**:
+
+- Default to completing deferred items from previous iterations
+- Allow substantive refactoring where it accelerates product maturity
+- Scope 2–4 candidates, each with clear product-completeness goals and trade-offs
+
+## 3. Lock Direction — grill-me
+
+Run the **grill-me skill** to stress-test candidate directions with the user:
+
+- Walk through trade-offs for each candidate
+- Converge on a **single iteration direction** with shared understanding
+- Document: locked direction, success criteria, non-goals
+
+## 4. Write Compass & Plans
+
+Produce harness artifacts:
+
+- `{ITERATION_DIR}/<iteration-id>-compass.md` — iteration vision, scope, roadmap batches, deferred items
+- `{PLAN_DIR}/<plan-id>-<name>.md` for each plan in this iteration
+- Register all plans in `{HARNESS_DIR}/status.json`
+
+## 5. Review Chain
+
+1. **@product-manager** — review compass; adjust scope and user-facing details; write or update specs in `{SPECS_DIR}/`
+2. **@architect** — review compass and specs; adjust technical architecture, interface contracts, and module boundaries
+3. **@writing-specialist** — full review of all documents for clarity, consistency, and completeness
+4. **PM** — final review; lock all documents; confirm Prepare phase gates pass
+
+## 6. Integration Branch
+
+- Create `iteration/<iteration-id>` from `main`
+- Register `spec_integration_branch` in `{HARNESS_DIR}/status.json`
+- Commit all documents to the integration branch and push to remote

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mstar-harness/opencode",
-  "version": "0.6.14",
+  "version": "0.6.15",
   "description": "Morning Star harness OpenCode plugin (skills bootstrap and agent loading).",
   "license": "MIT",
   "repository": {
@@ -14,6 +14,7 @@
     "dist",
     "harness-skills",
     "harness-agents",
+    "harness-commands",
     "AGENTS.md",
     "INSTALL.md"
   ],