syntaur 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,116 @@
+# Syntaur
+
+Syntaur is a local mission and assignment workflow for coding agents. It ships a CLI, a dashboard, a Claude Code plugin, and a Codex plugin.
+
+## Install and Run
+
+Requirements:
+
+- Node.js 20+
+- `npx` from npm
+
+Run Syntaur directly with `npx`:
+
+```bash
+npx syntaur@latest
+```
+
+This downloads the published `syntaur` package into npm's cache and runs the CLI. It does not do a global install unless you choose to install it globally yourself.
+
+On first run, Syntaur will:
+
+1. Initialize `~/.syntaur/`
+2. Offer to install the Claude Code plugin
+3. Offer to install the Codex plugin
+4. Ask where those plugins should be installed, with recommended defaults based on your current machine
+5. Offer to launch the dashboard
+
+You can also run setup explicitly:
+
+```bash
+npx syntaur@latest setup
+```
+
+Non-interactive setup:
+
+```bash
+npx syntaur@latest setup --yes
+npx syntaur@latest setup --yes --claude
+npx syntaur@latest setup --yes --codex
+npx syntaur@latest setup --yes --dashboard
+```
+
+## Plugin Install Paths
+
+Syntaur remembers the plugin install locations you choose in `~/.syntaur/config.md`.
+
+For Claude Code, Syntaur will detect the machine's local plugin marketplace when one exists and recommend installing into that marketplace's `plugins/` directory.
+
+Interactive commands will prompt for install locations:
+
+```bash
+npx syntaur@latest install-plugin
+npx syntaur@latest install-codex-plugin
+```
+
+You can also set paths explicitly:
+
+```bash
+npx syntaur@latest install-plugin --target-dir ~/.claude/plugins/marketplaces/user-plugins/plugins/syntaur
+npx syntaur@latest install-codex-plugin \
+  --target-dir ~/plugins/syntaur \
+  --marketplace-path ~/.agents/plugins/marketplace.json
+```
+
+Setup supports the same path overrides:
+
+```bash
+npx syntaur@latest setup \
+  --claude \
+  --claude-dir ~/.claude/plugins/marketplaces/user-plugins/plugins/syntaur \
+  --codex \
+  --codex-dir ~/plugins/syntaur \
+  --codex-marketplace-path ~/.agents/plugins/marketplace.json
+```
+
+## Common Commands
+
+```bash
+npx syntaur@latest dashboard
+npx syntaur@latest create-mission "My First Mission"
+npx syntaur@latest create-assignment "Implement feature" --mission my-first-mission
+npx syntaur@latest uninstall
+npx syntaur@latest uninstall --all
+```
+
+## Uninstall
+
+Remove Syntaur-managed Claude and Codex integrations:
+
+```bash
+npx syntaur@latest uninstall
+```
+
+Remove plugins and `~/.syntaur` data:
+
+```bash
+npx syntaur@latest uninstall --all
+```
+
+If your config points missions somewhere outside `~/.syntaur`, Syntaur will warn and leave that external directory alone.
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm test
+npx vitest run src/__tests__/adapter-templates.test.ts
+```
+
+Repo-local plugin linking for development:
+
+```bash
+npx syntaur@latest install-plugin --link
+npx syntaur@latest install-codex-plugin --link
+```

package/dist/dashboard/server.js

@@ -381,6 +381,13 @@ var init_paths = __esm({
   }
 });
 
+// src/templates/config.ts
+var init_config = __esm({
+  "src/templates/config.ts"() {
+    "use strict";
+  }
+});
+
 // src/utils/config.ts
 import { readFile as readFile2 } from "fs/promises";
 import { resolve as resolve3, isAbsolute } from "path";
@@ -528,6 +535,42 @@ function serializeStatusConfig(statuses) {
   }
   return lines.join("\n");
 }
+function stripTopLevelBlock(fmBlock, key) {
+  const blockStart = fmBlock.match(new RegExp(`^${key}:\\s*$`, "m"));
+  if (!blockStart) {
+    return fmBlock.replace(/\n+$/, "");
+  }
+  const startIdx = fmBlock.indexOf(blockStart[0]);
+  const before = fmBlock.slice(0, startIdx);
+  const after = fmBlock.slice(startIdx + blockStart[0].length);
+  const remaining = after.split("\n");
+  let endIdx = 0;
+  for (let i = 0; i < remaining.length; i++) {
+    const line = remaining[i];
+    if (line.trim() === "") {
+      endIdx = i + 1;
+      continue;
+    }
+    if (line.length > 0 && line[0] !== " ") {
+      break;
+    }
+    endIdx = i + 1;
+  }
+  return (before + remaining.slice(endIdx).join("\n")).replace(/\n+$/, "");
+}
+function parseOptionalAbsolutePath(value, fieldName) {
+  if (!value) {
+    return null;
+  }
+  const expanded = expandHome(String(value));
+  if (!isAbsolute(expanded)) {
+    console.warn(
+      `Warning: config.md ${fieldName} is not an absolute path ("${value}"), ignoring it`
+    );
+    return null;
+  }
+  return resolve3(expanded);
+}
 async function writeStatusConfig(statuses) {
   const configPath = resolve3(syntaurRoot(), "config.md");
   const statusBlock = serializeStatusConfig(statuses);
@@ -590,23 +633,7 @@ async function deleteStatusConfig() {
   if (!fmMatch) return;
   const fmBlock = fmMatch[2];
   const afterFrontmatter = existing.slice(fmMatch[0].length);
-  const statusesStart = fmBlock.match(/^statuses:\s*$/m);
-  if (!statusesStart) return;
-  const startIdx = fmBlock.indexOf(statusesStart[0]);
-  const before = fmBlock.slice(0, startIdx);
-  const after = fmBlock.slice(startIdx + statusesStart[0].length);
-  const remaining = after.split("\n");
-  let endIdx = 0;
-  for (let i = 0; i < remaining.length; i++) {
-    const line = remaining[i];
-    if (line.trim() === "") {
-      endIdx = i + 1;
-      continue;
-    }
-    if (line.length > 0 && line[0] !== " ") break;
-    endIdx = i + 1;
-  }
-  const cleanedFm = (before + remaining.slice(endIdx).join("\n")).replace(/\n+$/, "");
+  const cleanedFm = stripTopLevelBlock(fmBlock, "statuses");
   const newContent = `---
 ${cleanedFm}
 ---${afterFrontmatter}`;
@@ -637,15 +664,30 @@ async function readConfig() {
       trustLevel: fm["agentDefaults.trustLevel"] || DEFAULT_CONFIG.agentDefaults.trustLevel,
       autoApprove: fm["agentDefaults.autoApprove"] === "true" || DEFAULT_CONFIG.agentDefaults.autoApprove
     },
+    integrations: {
+      claudePluginDir: parseOptionalAbsolutePath(
+        fm["integrations.claudePluginDir"],
+        "integrations.claudePluginDir"
+      ),
+      codexPluginDir: parseOptionalAbsolutePath(
+        fm["integrations.codexPluginDir"],
+        "integrations.codexPluginDir"
+      ),
+      codexMarketplacePath: parseOptionalAbsolutePath(
+        fm["integrations.codexMarketplacePath"],
+        "integrations.codexMarketplacePath"
+      )
+    },
     statuses: parseStatusConfig(content)
   };
 }
 var DEFAULT_CONFIG;
-var init_config = __esm({
+var init_config2 = __esm({
   "src/utils/config.ts"() {
     "use strict";
     init_paths();
     init_fs();
+    init_config();
     DEFAULT_CONFIG = {
       version: "1.0",
       defaultMissionDir: defaultMissionDir(),
@@ -653,6 +695,11 @@ var init_config = __esm({
         trustLevel: "medium",
         autoApprove: false
       },
+      integrations: {
+        claudePluginDir: null,
+        codexPluginDir: null,
+        codexMarketplacePath: null
+      },
       statuses: null
     };
   }
@@ -1198,13 +1245,13 @@ var init_help = __esm({
       // --- Plugin & adapter setup (indices 13-16) ---
       {
         command: "syntaur install-plugin",
-        description: "Install the Syntaur Claude Code plugin into your home plugin directory.",
-        example: "syntaur install-plugin"
+        description: "Install the Syntaur Claude Code plugin, detecting the local Claude marketplace when available and prompting for the target directory when interactive.",
+        example: "syntaur install-plugin --target-dir ~/.claude/plugins/marketplaces/user-plugins/plugins/syntaur"
       },
       {
         command: "syntaur install-codex-plugin",
-        description: "Install the Syntaur Codex plugin and register its local marketplace entry.",
-        example: "syntaur install-codex-plugin"
+        description: "Install the Syntaur Codex plugin and register its marketplace entry, prompting for both paths when interactive.",
+        example: "syntaur install-codex-plugin --target-dir ~/plugins/syntaur --marketplace-path ~/.agents/plugins/marketplace.json"
       },
       {
         command: "syntaur uninstall",
@@ -2660,7 +2707,7 @@ var init_api = __esm({
     "use strict";
     init_lifecycle();
     init_fs();
-    init_config();
+    init_config2();
     init_parser();
     init_help();
     STALE_ASSIGNMENT_MS = 7 * 24 * 60 * 60 * 1e3;
@@ -3157,7 +3204,7 @@ function createWatcher(options) {
 
 // src/dashboard/server.ts
 init_fs();
-init_config();
+init_config2();
 
 // src/dashboard/api-write.ts
 init_lifecycle();
@@ -3229,6 +3276,9 @@ function toggleAcceptanceCriterion(content, index, checked) {
 // src/dashboard/api-write.ts
 init_api();
 
+// src/templates/index.ts
+init_config();
+
 // src/templates/manifest.ts
 function renderManifest(params) {
   return `---