@fro.bot/systematic 1.11.0 → 1.12.0

package/LICENSE

@@ -1,6 +1,6 @@
 # The MIT License (MIT)
 
-Copyright (c) 2022 Marcus R. Brown <git@mrbro.dev>
+Copyright (c) 2026 Marcus R. Brown <git@mrbro.dev>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

package/README.md

@@ -10,11 +10,12 @@
 
 [![Build Status](https://img.shields.io/github/actions/workflow/status/marcusrbrown/systematic/main.yaml?style=flat-square&label=build&labelColor=1a1a2e&color=4FD1C5)](https://github.com/marcusrbrown/systematic/actions)
 [![npm version](https://img.shields.io/npm/v/@fro.bot/systematic?style=flat-square&label=npm&labelColor=1a1a2e&color=E91E8C)](https://www.npmjs.com/package/@fro.bot/systematic)
+[![Docs](https://img.shields.io/badge/docs-fro.bot/systematic-4FD1C5?style=flat-square&labelColor=1a1a2e)](https://fro.bot/systematic)
 [![License](https://img.shields.io/badge/license-MIT-F5A623?style=flat-square&labelColor=1a1a2e)](LICENSE)
 
 <br>
 
-**[Overview](#overview)** · **[Quick Start](#quick-start)** · **[Skills](#skills)** · **[Agents](#agents)** · **[Commands](#commands)** · **[Development](#development)**
+**[Overview](#overview)** · **[Quick Start](#quick-start)** · **[Skills](#skills)** · **[Agents](#agents)** · **[Commands](#commands)** · **[CLI](#cli)** · **[Configuration](#configuration)** · **[Development](#development)**
 
 </div>
 
@@ -37,11 +38,12 @@ Most AI coding assistants respond to requests without structure or methodology.
 
 ### Key Features
 
-- **🧠 Structured Skills** — Pre-built workflows for brainstorming, planning, and code review
-- **🤖 Specialized Agents** — Purpose-built subagents for architecture, security, and performance
-- **⚡ Zero Configuration** — Works immediately after installation via config hooks
-- **🔧 Extensible** — Add project-specific skills and commands alongside bundled ones
-- **📦 Batteries Included** — Skills, agents, and commands ship with the npm package
+- **Structured Skills** — Pre-built workflows for brainstorming, planning, and code review
+- **Specialized Agents** — Purpose-built subagents for architecture, security, and performance
+- **Zero Configuration** — Works immediately after installation via config hooks
+- **Extensible** — Add project-specific skills and commands alongside bundled ones
+- **Batteries Included** — 8 skills, 11 agents, and 9 commands ship with the npm package
+- **CLI Tooling** — Inspect, list, and convert assets from the command line
 
 ## Quick Start
 
@@ -168,16 +170,52 @@ Commands are slash-invokable shortcuts that trigger workflows or actions.
 | `/workflows:plan` | Create detailed implementation plans |
 | `/workflows:review` | Run code review with specialized agents |
 | `/workflows:work` | Execute planned work systematically |
-| `/workflows:compound` | Build compound documentation |
+| `/workflows:compound` | Document recently solved problems to build team knowledge |
 
 ### Utility Commands
 
 | Command | Description |
 |---------|-------------|
-| `/systematic:lfg` | "Let's go" — start working immediately |
-| `/systematic:create-agent-skill` | Create a new skill with guidance |
-| `/systematic:deepen-plan` | Add detail to existing plans |
-| `/systematic:agent-native-audit` | Audit code for agent-native patterns |
+| `/systematic:lfg` | Full autonomous engineering workflow — plan, then execute |
+| `/systematic:create-agent-skill` | Create a new skill with expert guidance |
+| `/systematic:deepen-plan` | Enhance a plan with parallel research for each section |
+| `/systematic:agent-native-audit` | Audit code for agent-native architecture patterns |
+
+## CLI
+
+Systematic includes a CLI for inspecting and converting assets outside of OpenCode.
+
+```
+systematic <command> [options]
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `list [type]` | List available skills, agents, or commands |
+| `convert <type> <file>` | Convert a CEP file and output the result to stdout |
+| `config show` | Show current configuration and file contents |
+| `config path` | Print config file locations |
+
+### Examples
+
+```bash
+# List all bundled skills
+systematic list skills
+
+# List all bundled agents
+systematic list agents
+
+# Convert a Claude Code agent to OpenCode format
+systematic convert agent ./agents/my-agent.md
+
+# Convert with a specific agent mode
+systematic convert agent ./agents/my-agent.md --mode=primary
+
+# Show configuration
+systematic config show
+```
 
 ## Configuration
 
@@ -185,16 +223,31 @@ Systematic works out of the box, but you can customize it via configuration file
 
 ### Plugin Configuration
 
-Create `~/.config/opencode/systematic.json` or `.opencode/systematic.json` to disable specific bundled content:
+Configuration is loaded from multiple locations and merged (later sources override earlier ones):
+
+1. **User config:** `~/.config/opencode/systematic.json`
+2. **Project config:** `.opencode/systematic.json`
+3. **Custom config:** `$OPENCODE_CONFIG_DIR/systematic.json` (if `OPENCODE_CONFIG_DIR` is set)
 
 ```json
 {
   "disabled_skills": ["git-worktree"],
   "disabled_agents": [],
-  "disabled_commands": []
+  "disabled_commands": [],
+  "bootstrap": {
+    "enabled": true
+  }
 }
 ```
 
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `disabled_skills` | `string[]` | `[]` | Skills to exclude from registration |
+| `disabled_agents` | `string[]` | `[]` | Agents to exclude from registration |
+| `disabled_commands` | `string[]` | `[]` | Commands to exclude from registration |
+| `bootstrap.enabled` | `boolean` | `true` | Inject the `using-systematic` guide into system prompts |
+| `bootstrap.file` | `string` | — | Custom bootstrap file path (overrides default) |
+
 ### Project-Specific Content
 
 Add your own skills, agents, and commands alongside bundled ones:
@@ -218,7 +271,7 @@ The plugin exposes one tool to OpenCode:
 
 | Tool | Description |
 |------|-------------|
-| `systematic_skill` | Load Systematic bundled skills by name |
+| `systematic_skill` | Load Systematic bundled skills by name. Lists available skills in its description and returns formatted skill content when invoked. |
 
 For non-Systematic skills (project or user-level), use OpenCode's native `skill` tool.
 
@@ -246,9 +299,9 @@ flowchart TB
     style G fill:#0f0f23,stroke:#F5A623,color:#B2F5EA
 ```
 
-1. **`config` hook** — Merges bundled assets into your OpenCode configuration
-2. **`tool` hook** — Registers the `systematic_skill` tool for loading skills
-3. **`system.transform` hook** — Injects the "Using Systematic" guide into system prompts
+1. **`config` hook** — Discovers and merges bundled skills, agents, and commands into your OpenCode configuration. Existing config takes precedence over bundled content. Skills are registered as commands with the `systematic:` prefix.
+2. **`tool` hook** — Registers the `systematic_skill` tool, which lists available skills in its XML description and loads skill content on demand.
+3. **`system.transform` hook** — Injects the "Using Systematic" bootstrap guide into system prompts, teaching the AI how to discover and invoke skills.
 
 This architecture ensures skills, agents, and commands are available immediately without manual setup.
 
@@ -285,20 +338,27 @@ bun test
 ### Project Structure
 
 ```
+systematic/
 ├── src/
-│   ├── index.ts              # Plugin entry point
+│   ├── index.ts              # Plugin entry point (SystematicPlugin)
 │   ├── cli.ts                # CLI entry point
 │   └── lib/
 │       ├── bootstrap.ts      # System prompt injection
-│       ├── config.ts         # JSONC config loading
-│       ├── config-handler.ts # OpenCode config hook
-│       ├── skill-tool.ts     # systematic_skill tool
+│       ├── config.ts         # JSONC config loading + merging
+│       ├── config-handler.ts # OpenCode config hook implementation
+│       ├── converter.ts      # CEP-to-OpenCode content conversion
+│       ├── skill-tool.ts     # systematic_skill tool factory
+│       ├── skill-loader.ts   # Skill content loading + formatting
 │       ├── skills.ts         # Skill discovery
 │       ├── agents.ts         # Agent discovery
-│       └── commands.ts       # Command discovery
-├── skills/                   # Bundled skills (SKILL.md files)
-├── agents/                   # Bundled agents (Markdown)
-├── commands/                 # Bundled commands (Markdown)
+│       ├── commands.ts       # Command discovery
+│       ├── frontmatter.ts    # YAML frontmatter parsing
+│       ├── validation.ts     # Agent config validation + type guards
+│       └── walk-dir.ts       # Recursive directory walker
+├── skills/                   # 8 bundled skills (SKILL.md files)
+├── agents/                   # 11 bundled agents (4 categories)
+├── commands/                 # 9 bundled commands (with workflows/ subdir)
+├── docs/                     # Starlight documentation site
 ├── tests/
 │   ├── unit/                 # Unit tests
 │   └── integration/          # Integration tests
@@ -316,6 +376,9 @@ bun test tests/unit/skills.test.ts
 
 # Run integration tests
 bun test tests/integration
+
+# Run all tests
+bun test
 ```
 
 ### Contributing
@@ -324,13 +387,15 @@ See [`AGENTS.md`](./AGENTS.md) for detailed development guidelines, code style c
 
 ## Converting from Claude Code
 
-Migrating skills, agents, or commands from Claude Code (CEP) to Systematic? See the [Conversion Guide](./docs/CONVERSION-GUIDE.md) for field mappings and examples.
+Migrating skills, agents, or commands from Claude Code (CEP) to Systematic? See the [Conversion Guide](https://fro.bot/systematic/guides/conversion-guide/) for field mappings and examples. Also available as [local Markdown](./docs/CONVERSION-GUIDE.md).
 
 ## References
 
+- [Systematic Documentation](https://fro.bot/systematic) — Full documentation site
 - [OpenCode Documentation](https://opencode.ai/docs/) — Official OpenCode platform docs
+- [OpenCode Plugin API](https://opencode.ai/docs/plugins) — Plugin development reference
 - [Compound Engineering Plugin](https://github.com/EveryInc/compound-engineering-plugin) — Original Claude Code workflows
-- [Plugin Source Code](https://github.com/marcusrbrown/systematic) — View the implementation
+- [Source Code](https://github.com/marcusrbrown/systematic) — View the implementation
 
 ## License
 

package/dist/cli.js

@@ -6,12 +6,24 @@ import {
   findCommandsInDir,
   findSkillsInDir,
   getConfigPaths
-} from "./index-we4f9de3.js";
+} from "./index-0ftaxvrt.js";
 
 // src/cli.ts
 import fs from "fs";
 import path from "path";
-var VERSION = "0.1.0";
+var getPackageVersion = () => {
+  try {
+    const packageJsonPath = path.resolve(import.meta.dirname, "..", "package.json");
+    if (!fs.existsSync(packageJsonPath))
+      return "unknown";
+    const content = fs.readFileSync(packageJsonPath, "utf8");
+    const parsed = JSON.parse(content);
+    return parsed.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+};
+var VERSION = getPackageVersion();
 var HELP = `
 systematic - OpenCode plugin for systematic engineering workflows
 

package/dist/{index-we4f9de3.js → index-0ftaxvrt.js}

@@ -138,7 +138,7 @@ function extractBashPermission(data) {
   }
   return null;
 }
-function buildPermissionObject(edit, bash, webfetch, doom_loop, external_directory) {
+function buildPermissionObject(edit, bash, webfetch, doom_loop, external_directory, task, skill) {
   const permission = {};
   if (edit)
     permission.edit = edit;
@@ -150,6 +150,10 @@ function buildPermissionObject(edit, bash, webfetch, doom_loop, external_directo
     permission.doom_loop = doom_loop;
   if (external_directory)
     permission.external_directory = external_directory;
+  if (task)
+    permission.task = task;
+  if (skill)
+    permission.skill = skill;
   return Object.keys(permission).length > 0 ? permission : undefined;
 }
 function normalizePermission(value) {
@@ -170,7 +174,13 @@ function normalizePermission(value) {
   const external_directory = extractSimplePermission(value, "external_directory");
   if (external_directory === null)
     return;
-  return buildPermissionObject(edit, bash, webfetch, doom_loop, external_directory);
+  const task = extractSimplePermission(value, "task");
+  if (task === null)
+    return;
+  const skill = extractSimplePermission(value, "skill");
+  if (skill === null)
+    return;
+  return buildPermissionObject(edit, bash, webfetch, doom_loop, external_directory, task, skill);
 }
 function extractString(data, key, fallback = "") {
   const value = data[key];
@@ -262,7 +272,8 @@ function extractAgentFrontmatter(content) {
     disable: extractBoolean(data, "disable"),
     mode: isAgentMode(data.mode) ? data.mode : undefined,
     color: extractNonEmptyString(data, "color"),
-    maxSteps: extractNumber(data, "maxSteps"),
+    steps: extractNumber(data, "steps"),
+    hidden: extractBoolean(data, "hidden") ?? undefined,
     permission: normalizePermission(data.permission)
   };
 }
@@ -308,6 +319,7 @@ function extractCommandFrontmatter(content) {
 
 // src/lib/converter.ts
 import fs3 from "fs";
+var CONVERTER_VERSION = 2;
 var cache = new Map;
 var TOOL_MAPPINGS = [
   [/\bTask\s+tool\b/gi, "delegate_task tool"],
@@ -336,18 +348,42 @@ var PATH_REPLACEMENTS = [
   [/\/compound-engineering:/g, "/systematic:"],
   [/compound-engineering:/g, "systematic:"]
 ];
-var CC_ONLY_SKILL_FIELDS = [
-  "model",
-  "allowed-tools",
-  "allowedTools",
-  "disable-model-invocation",
-  "disableModelInvocation",
-  "user-invocable",
-  "userInvocable",
-  "context",
-  "agent"
-];
-var CC_ONLY_COMMAND_FIELDS = ["argument-hint", "argumentHint"];
+var TOOL_NAME_MAP = {
+  task: "delegate_task",
+  todowrite: "todowrite",
+  askuserquestion: "question",
+  websearch: "google_search",
+  webfetch: "webfetch",
+  skill: "skill",
+  read: "read",
+  write: "write",
+  edit: "edit",
+  bash: "bash",
+  grep: "grep",
+  glob: "glob"
+};
+var PERMISSION_MODE_MAP = {
+  full: {
+    edit: "allow",
+    bash: "allow",
+    webfetch: "allow"
+  },
+  default: {
+    edit: "ask",
+    bash: "ask",
+    webfetch: "ask"
+  },
+  plan: {
+    edit: "deny",
+    bash: "deny",
+    webfetch: "ask"
+  },
+  bypassPermissions: {
+    edit: "allow",
+    bash: "allow",
+    webfetch: "allow"
+  }
+};
 function inferTemperature(name, description) {
   const sample = `${name} ${description ?? ""}`.toLowerCase();
   if (/(review|audit|security|sentinel|oracle|lint|verification|guardian)/.test(sample)) {
@@ -384,27 +420,6 @@ function transformBody(body) {
   }
   return result;
 }
-function removeFields(data, fieldsToRemove) {
-  const result = {};
-  for (const [key, value] of Object.entries(data)) {
-    if (!fieldsToRemove.includes(key)) {
-      result[key] = value;
-    }
-  }
-  return result;
-}
-function transformSkillFrontmatter(data) {
-  return removeFields(data, CC_ONLY_SKILL_FIELDS);
-}
-function transformCommandFrontmatter(data) {
-  const cleaned = removeFields(data, CC_ONLY_COMMAND_FIELDS);
-  if (typeof cleaned.model === "string" && cleaned.model !== "inherit") {
-    cleaned.model = normalizeModel(cleaned.model);
-  } else if (cleaned.model === "inherit") {
-    delete cleaned.model;
-  }
-  return cleaned;
-}
 function normalizeModel(model) {
   if (model.includes("/"))
     return model;
@@ -418,37 +433,127 @@ function normalizeModel(model) {
     return `google/${model}`;
   return `anthropic/${model}`;
 }
-function addOptionalFields(target, data) {
-  if (typeof data.top_p === "number")
-    target.top_p = data.top_p;
-  if (isToolsMap(data.tools))
-    target.tools = data.tools;
-  if (typeof data.disable === "boolean")
-    target.disable = data.disable;
-  if (typeof data.color === "string")
-    target.color = data.color;
-  if (typeof data.maxSteps === "number")
-    target.maxSteps = data.maxSteps;
-  const permission = normalizePermission(data.permission);
-  if (permission)
-    target.permission = permission;
+function canonicalizeToolName(name) {
+  const lower = name.trim().toLowerCase();
+  return TOOL_NAME_MAP[lower] ?? lower;
+}
+function isValidSteps(value) {
+  return typeof value === "number" && Number.isFinite(value) && Number.isInteger(value) && value > 0;
+}
+function mapStepsField(data) {
+  if (data.steps !== undefined) {
+    if (isValidSteps(data.steps)) {
+      delete data.maxTurns;
+      delete data.maxSteps;
+    }
+    return;
+  }
+  const candidates = [];
+  if (isValidSteps(data.maxTurns))
+    candidates.push(data.maxTurns);
+  if (isValidSteps(data.maxSteps))
+    candidates.push(data.maxSteps);
+  if (candidates.length > 0) {
+    data.steps = Math.min(...candidates);
+    delete data.maxTurns;
+    delete data.maxSteps;
+  }
+}
+function mapToolsField(data) {
+  if (data.tools !== undefined && !Array.isArray(data.tools)) {
+    if (isToolsMap(data.tools)) {
+      mergeDisallowedTools(data);
+    }
+    return;
+  }
+  if (Array.isArray(data.tools)) {
+    const toolsMap = {};
+    for (const tool of data.tools) {
+      if (typeof tool === "string") {
+        toolsMap[canonicalizeToolName(tool)] = true;
+      }
+    }
+    if (Object.keys(toolsMap).length > 0) {
+      data.tools = toolsMap;
+    } else {
+      delete data.tools;
+    }
+  }
+  mergeDisallowedTools(data);
+}
+function mergeDisallowedTools(data) {
+  if (!Array.isArray(data.disallowedTools))
+    return;
+  const existing = isToolsMap(data.tools) ? data.tools : {};
+  for (const tool of data.disallowedTools) {
+    if (typeof tool === "string") {
+      existing[canonicalizeToolName(tool)] = false;
+    }
+  }
+  if (Object.keys(existing).length > 0) {
+    data.tools = existing;
+  }
+  delete data.disallowedTools;
+}
+function mapPermissionMode(data) {
+  if (data.permission !== undefined) {
+    const normalized = normalizePermission(data.permission);
+    if (normalized) {
+      data.permission = normalized;
+      delete data.permissionMode;
+      return;
+    }
+  }
+  if (typeof data.permissionMode !== "string")
+    return;
+  const mapped = PERMISSION_MODE_MAP[data.permissionMode];
+  data.permission = mapped ?? { edit: "ask", bash: "ask", webfetch: "ask" };
+  delete data.permissionMode;
+}
+function mapHiddenField(data) {
+  if (data["disable-model-invocation"] === true || data.disableModelInvocation === true) {
+    data.hidden = true;
+    delete data["disable-model-invocation"];
+    delete data.disableModelInvocation;
+  }
+}
+function normalizeModelField(data) {
+  if (typeof data.model === "string" && data.model !== "inherit") {
+    data.model = normalizeModel(data.model);
+  } else if (data.model === "inherit") {
+    delete data.model;
+  }
 }
 function transformAgentFrontmatter(data, agentMode) {
+  const result = { ...data };
+  result.mode = isAgentMode(data.mode) ? data.mode : agentMode;
   const name = typeof data.name === "string" ? data.name : "";
   const description = typeof data.description === "string" ? data.description : "";
-  const mode = isAgentMode(data.mode) ? data.mode : agentMode;
-  const newData = { mode };
   if (description) {
-    newData.description = description;
+    result.description = description;
   } else if (name) {
-    newData.description = `${name} agent`;
+    result.description = `${name} agent`;
   }
-  if (typeof data.model === "string" && data.model !== "inherit") {
-    newData.model = normalizeModel(data.model);
+  normalizeModelField(result);
+  result.temperature = typeof data.temperature === "number" ? data.temperature : inferTemperature(name, description);
+  mapStepsField(result);
+  mapToolsField(result);
+  mapPermissionMode(result);
+  mapHiddenField(result);
+  return result;
+}
+function transformSkillFrontmatter(data) {
+  const result = { ...data };
+  normalizeModelField(result);
+  if (result.context === "fork") {
+    result.subtask = true;
   }
-  newData.temperature = typeof data.temperature === "number" ? data.temperature : inferTemperature(name, description);
-  addOptionalFields(newData, data);
-  return newData;
+  return result;
+}
+function transformCommandFrontmatter(data) {
+  const result = { ...data };
+  normalizeModelField(result);
+  return result;
 }
 function convertContent(content, type, options = {}) {
   if (content === "")
@@ -458,7 +563,7 @@ function convertContent(content, type, options = {}) {
     return options.skipBodyTransform ? content : transformBody(content);
   }
   if (parseError) {
-    return content;
+    return options.skipBodyTransform ? content : transformBody(content);
   }
   const shouldTransformBody = !options.skipBodyTransform;
   const transformedBody = shouldTransformBody ? transformBody(body) : body;
@@ -484,7 +589,7 @@ function convertFileWithCache(filePath, type, options = {}) {
   const fd = fs3.openSync(filePath, "r");
   try {
     const stats = fs3.fstatSync(fd);
-    const cacheKey = `${filePath}:${type}:${options.source ?? "bundled"}:${options.agentMode ?? "subagent"}:${options.skipBodyTransform ?? false}`;
+    const cacheKey = `${CONVERTER_VERSION}:${filePath}:${type}:${options.source ?? "bundled"}:${options.agentMode ?? "subagent"}:${options.skipBodyTransform ?? false}`;
     const cached = cache.get(cacheKey);
     if (cached != null && cached.mtimeMs === stats.mtimeMs) {
       return cached.converted;

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   findSkillsInDir,
   loadConfig,
   parseFrontmatter
-} from "./index-we4f9de3.js";
+} from "./index-0ftaxvrt.js";
 
 // src/index.ts
 import fs3 from "fs";
@@ -22,7 +22,7 @@ import path from "path";
 function getToolMappingTemplate(bundledSkillsDir) {
   return `**Tool Mapping for OpenCode:**
 When skills reference tools you don't have, substitute OpenCode equivalents:
-- \`TodoWrite\` \u2192 \`update_plan\`
+- \`TodoWrite\` \u2192 \`todowrite\`
 - \`Task\` tool with subagents \u2192 Use OpenCode's subagent system (@mention)
 - \`Skill\` tool \u2192 OpenCode's native \`skill\` tool
 - \`SystematicSkill\` tool \u2192 \`systematic_skill\` (Systematic plugin skills)
@@ -155,7 +155,8 @@ function loadAgentAsConfig(agentInfo) {
       disable,
       mode,
       color,
-      maxSteps,
+      steps,
+      hidden,
       permission
     } = extractAgentFrontmatter(converted);
     const config = {
@@ -176,8 +177,10 @@ function loadAgentAsConfig(agentInfo) {
       config.mode = mode;
     if (color !== undefined)
       config.color = color;
-    if (maxSteps !== undefined)
-      config.maxSteps = maxSteps;
+    if (steps !== undefined)
+      config.steps = steps;
+    if (hidden !== undefined)
+      config.hidden = hidden;
     if (permission !== undefined)
       config.permission = permission;
     return config;

package/dist/lib/agents.d.ts

@@ -21,7 +21,9 @@ export interface AgentFrontmatter {
     /** Hex color code */
     color?: string;
     /** Max agentic iterations */
-    maxSteps?: number;
+    steps?: number;
+    /** Whether this agent is hidden from model invocation */
+    hidden?: boolean;
     /** Permission settings */
     permission?: PermissionConfig;
 }

package/dist/lib/manifest.d.ts

@@ -0,0 +1,21 @@
+export interface ManifestSource {
+    repo: string;
+    branch: string;
+    url: string;
+}
+export interface ManifestDefinition {
+    source: string;
+    upstream_path: string;
+    upstream_commit: string;
+    synced_at: string;
+    notes: string;
+}
+export interface SyncManifest {
+    $schema?: string;
+    sources: Record<string, ManifestSource>;
+    definitions: Record<string, ManifestDefinition>;
+}
+export declare function validateManifest(data: unknown): data is SyncManifest;
+export declare function readManifest(filePath: string): SyncManifest | null;
+export declare function writeManifest(filePath: string, manifest: SyncManifest): void;
+export declare function findStaleEntries(manifest: SyncManifest, existingPaths: string[]): string[];

package/dist/lib/validation.d.ts

@@ -9,6 +9,8 @@ export interface PermissionConfig {
     webfetch?: PermissionSetting;
     doom_loop?: PermissionSetting;
     external_directory?: PermissionSetting;
+    task?: PermissionSetting;
+    skill?: PermissionSetting;
 }
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
 export declare function isPermissionSetting(value: unknown): value is PermissionSetting;

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@fro.bot/systematic",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "Structured engineering workflows for OpenCode",
   "type": "module",
+  "homepage": "https://fro.bot/systematic",
   "main": "./dist/index.js",
   "bin": {
     "systematic": "./dist/cli.js"
@@ -19,6 +20,9 @@
     "agents",
     "commands"
   ],
+  "workspaces": [
+    "docs"
+  ],
   "scripts": {
     "clean": "rimraf dist",
     "build": "bun run clean && bun build src/index.ts src/cli.ts --outdir dist --target bun --splitting --packages external && tsc --emitDeclarationOnly",
@@ -29,6 +33,10 @@
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
     "fix": "bun run lint --fix",
+    "docs:dev": "bun run --cwd docs dev",
+    "docs:build": "bun run docs:generate && bun run --cwd docs build",
+    "docs:preview": "bun run --cwd docs preview",
+    "docs:generate": "bun docs/scripts/transform-content.ts",
     "prepublishOnly": "bun run build"
   },
   "keywords": [
@@ -53,6 +61,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.0.0",
     "@opencode-ai/plugin": "^1.1.30",
+    "@opencode-ai/sdk": "^1.1.30",
     "@types/bun": "latest",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.0.0",