opencode-architect 0.2.4 → 0.4.0

package/assets/templates/package-analysis.template.md

@@ -1,60 +0,0 @@
-# Package Analysis Template
-
-Use this template to document extension analysis before packaging.
-
-## Source Information
-
-- **Source Path**: [path to .opencode/ or existing package]
-- **Source Type**: [project-local | existing-package]
-- **Target Package Name**: opencode-[name]
-
-## Extension Inventory
-
-### Skills
-| Name | Description | Dependencies | Issues |
-| ---- | ----------- | ------------ | ------ |
-|      |             |              |        |
-
-### Commands
-| Name | Description | Template Vars | Issues |
-| ---- | ----------- | ------------- | ------ |
-|      |             |               |        |
-
-### Agents
-| Name | Description | Mode | Issues |
-| ---- | ----------- | ---- | ------ |
-|      |             |      |        |
-
-### Plugins
-| File | Hooks Used | Merge Strategy | Issues |
-| ---- | ---------- | -------------- | ------ |
-|      |            |                |        |
-
-### Tools
-| File | Tool Name | Merge Strategy | Issues |
-| ---- | --------- | -------------- | ------ |
-|      |           |                |        |
-
-## Dependencies
-
-From `.opencode/package.json`:
-- [list dependencies]
-
-## Packaging Assessment
-
-- **Complexity**: [simple | medium | complex]
-- **Requires Guidance**: [yes | no]
-- **Guidance Needed For**: [plugins | tools | both | none]
-
-## Recommendations
-
-1. [recommendation 1]
-2. [recommendation 2]
-
-## Merge Decisions (if applicable)
-
-### Plugin Merge
-- [decision and rationale]
-
-### Tool Merge
-- [decision and rationale]

package/commands/sync-docs.ts

@@ -1,9 +0,0 @@
-import type { Config } from "@opencode-ai/sdk";
-
-export const command: NonNullable<Config["command"]>[string] = {
-  description: "Sync OpenCode docs into ~/.cache/opencode/opencode-architect/docs",
-  template:
-    "Use the sync-docs tool to fetch the latest OpenCode documentation into `~/.cache/opencode/opencode-architect/docs`.",
-};
-
-export default command;

package/scripts/fetch-opencode-docs.ts

@@ -1,193 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-
-import type { Logger } from "./logger";
-import { ConsoleLogger } from "./logger";
-
-interface ExternalDoc {
-  url: string;
-  filename: string;
-}
-
-export class OpenCodeDocsFetcher {
-  private readonly sitemapUrl: string;
-  private readonly docsDir: string;
-  private readonly externalDocs: ExternalDoc[];
-  private readonly logger: Logger;
-
-  public constructor(logger: Logger | null = null) {
-    this.sitemapUrl = "https://opencode.ai/sitemap.xml";
-    this.docsDir = path.join(
-      os.homedir(),
-      ".cache",
-      "opencode",
-      "opencode-architect",
-      "docs",
-    );
-    this.logger = logger ?? new ConsoleLogger();
-    this.externalDocs = [
-      {
-        url: "https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices.md",
-        filename: "claude-skill-best-practices.md",
-      },
-      {
-        url: "https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-4-best-practices.md",
-        filename: "claude-4-best-practices.md",
-      },
-    ];
-  }
-
-  public async run(): Promise<void> {
-    try {
-      await this.ensureDocsDir();
-      const sitemap = await this.fetchText(this.sitemapUrl);
-      const docUrls = this.extractDocUrls(sitemap);
-      const markdownUrls = this.buildMarkdownUrls(docUrls);
-      await this.downloadDocs(markdownUrls);
-      await this.downloadExternalDocs();
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      this.logger.error(`Failed to fetch OpenCode docs: ${message}`);
-      process.exitCode = 1;
-    }
-  }
-
-  private async ensureDocsDir(): Promise<void> {
-    await mkdir(this.docsDir, { recursive: true });
-  }
-
-  private async fetchText(url: string): Promise<string> {
-    const response = await fetch(url, {
-      headers: {
-        "User-Agent": "opencode-docs-fetcher",
-      },
-    });
-    if (!response.ok) {
-      throw new Error(`Request failed (${response.status}) for ${url}`);
-    }
-    return await response.text();
-  }
-
-  private extractDocUrls(sitemap: string): string[] {
-    const urls: string[] = [];
-    const regex = /<loc>([^<]+)<\/loc>/g;
-    let match: RegExpExecArray | null = regex.exec(sitemap);
-    while (match) {
-      const url = match[1];
-      if (url !== undefined) {
-        try {
-          const parsed = new URL(url);
-          if (parsed.pathname.startsWith("/docs/")) {
-            urls.push(url);
-          }
-        } catch {
-          continue;
-        }
-      }
-      match = regex.exec(sitemap);
-    }
-    return Array.from(new Set(urls));
-  }
-
-  private buildMarkdownUrls(urls: string[]): string[] {
-    const markdownUrls: string[] = [];
-    for (const url of urls) {
-      const parsed = new URL(url);
-      if (!parsed.pathname.startsWith("/docs/")) {
-        continue;
-      }
-      const normalizedPath = this.normalizeDocPath(parsed.pathname);
-      if (normalizedPath === "/docs") {
-        continue;
-      }
-      const markdownUrl = `${parsed.origin}${normalizedPath}.md`;
-      markdownUrls.push(markdownUrl);
-    }
-    return Array.from(new Set(markdownUrls));
-  }
-
-  private normalizeDocPath(pathname: string): string {
-    if (pathname.endsWith("/")) {
-      return pathname.slice(0, -1);
-    }
-    return pathname;
-  }
-
-  private async downloadDocs(urls: string[]): Promise<void> {
-    let successCount = 0;
-    let failureCount = 0;
-    for (const url of urls) {
-      try {
-        const content = await this.fetchText(url);
-        const filename = this.buildFilename(url);
-        const filePath = path.join(this.docsDir, filename);
-        await writeFile(filePath, content);
-        successCount += 1;
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        this.logger.error(`Failed to fetch ${url}: ${message}`);
-        failureCount += 1;
-      }
-    }
-
-    this.logger.info(
-      `OpenCode docs fetch complete. Success: ${successCount}, Failed: ${failureCount}.`,
-    );
-  }
-
-  private async downloadExternalDocs(): Promise<void> {
-    let successCount = 0;
-    let failureCount = 0;
-    for (const doc of this.externalDocs) {
-      try {
-        const content = await this.fetchText(doc.url);
-        const filePath = path.join(this.docsDir, doc.filename);
-        await writeFile(filePath, content);
-        successCount += 1;
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        this.logger.error(`Failed to fetch ${doc.url}: ${message}`);
-        failureCount += 1;
-      }
-    }
-
-    this.logger.info(
-      `External docs fetch complete. Success: ${successCount}, Failed: ${failureCount}.`,
-    );
-  }
-
-  private buildFilename(url: string): string {
-    const parsed = new URL(url);
-    const pathname = parsed.pathname;
-    if (pathname === "/docs.md" || pathname === "/docs/.md") {
-      return "index.md";
-    }
-
-    let relative = pathname;
-    if (relative.startsWith("/docs/")) {
-      relative = relative.slice("/docs/".length);
-    } else if (relative.startsWith("/docs")) {
-      relative = relative.slice("/docs".length);
-    }
-
-    if (relative.startsWith("/")) {
-      relative = relative.slice(1);
-    }
-
-    if (relative.length === 0) {
-      return "index.md";
-    }
-
-    const normalized = relative.replace(/\//g, "-");
-    if (normalized.endsWith(".md")) {
-      return normalized;
-    }
-    return `${normalized}.md`;
-  }
-
-}
-
-if (import.meta.main) {
-  void new OpenCodeDocsFetcher().run();
-}

package/scripts/logger.ts

@@ -1,20 +0,0 @@
-export interface Logger {
-  info(message: string): void;
-  error(message: string): void;
-}
-
-export class ConsoleLogger implements Logger {
-  public info(message: string): void {
-    console.log(message);
-  }
-
-  public error(message: string): void {
-    console.error(message);
-  }
-}
-
-export class SilentLogger implements Logger {
-  public info(_message: string): void {}
-
-  public error(_message: string): void {}
-}

package/tools/sync-docs.ts

@@ -1,24 +0,0 @@
-import { tool } from "@opencode-ai/plugin";
-
-import { OpenCodeDocsFetcher } from "../scripts/fetch-opencode-docs";
-
-type ToolDefinition = ReturnType<typeof tool>;
-
-function createSyncDocsTool(): ToolDefinition {
-  return tool({
-    description: "Sync OpenCode documentation by fetching the latest docs from opencode.ai",
-    args: {},
-    async execute(_args, _context) {
-      try {
-        const fetcher = new OpenCodeDocsFetcher();
-        await fetcher.run();
-        return "Successfully synced OpenCode documentation.";
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return `Failed to sync docs: ${message}`;
-      }
-    },
-  });
-}
-
-export { createSyncDocsTool };