cc-codeconductor 0.2.6 → 0.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-codeconductor",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "A multi-agent orchestration framework for AI-assisted software engineering workflows.",
   "keywords": [
     "ai",
@@ -29,6 +29,7 @@
   },
   "type": "module",
   "bin": {
+    "cc-codeconductor": "./dist/index.js",
     "codeconductor": "./dist/index.js"
   },
   "scripts": {

package/presets/opencode/README.md

@@ -24,7 +24,7 @@ providers)** models.
 | `deepseek-v4-pro` | DeepSeek        | Reasoning complejo, arquitectura | Architect, orchestrator    |
 | `mimo-v2.5-pro`   | MiniMax         | Razonamiento matemático, código  | Implementer                |
 | `minimax-m2.7`    | MiniMax         | Tareas equilibradas              | Tester, orchestrator       |
-| `qwen-3.6-plus`   | Qwen            | Rápido, eficiente                | Reviewer, Task Coach, Docs |
+| `qwen3.6-plus`    | Qwen            | Rápido, eficiente                | Reviewer, Task Coach, Docs |
 | `kimi-k2-6`       | Kimi (Moonshot) | Conversación natural             | Task Coach, Docs           |
 
 ---
@@ -37,10 +37,10 @@ providers)** models.
 | **Architect**     | `claude-opus-4-7`           | `deepseek-v4-pro`         | `mimo-v2.5-pro`   |
 | **Implementer**   | `claude-sonnet-4-6`         | `mimo-v2.5-pro`           | `minimax-m2.7`    |
 | **Tester**        | `claude-sonnet-4-6`         | `minimax-m2.7`            | `deepseek-v4-pro` |
-| **Reviewer**      | `claude-sonnet-4-6`         | `qwen-3.6-plus`           | `minimax-m2.7`    |
-| **Task Coach**    | `claude-haiku-4-5-20251001` | `qwen-3.6-plus`           | `kimi-k2.6`       |
-| **Docs**          | `claude-haiku-4-5-20251001` | `qwen-3.6-plus`           | `kimi-k2.6`       |
-| **Repo Explorer** | `claude-haiku-4-5-20251001` | `qwen-3.6-plus`           | `kimi-k2.6`       |
+| **Reviewer**      | `claude-sonnet-4-6`         | `qwen3.6-plus`            | `minimax-m2.7`    |
+| **Task Coach**    | `claude-haiku-4-5-20251001` | `qwen3.6-plus`            | `kimi-k2.6`       |
+| **Docs**          | `claude-haiku-4-5-20251001` | `qwen3.6-plus`            | `kimi-k2.6`       |
+| **Repo Explorer** | `claude-haiku-4-5-20251001` | `qwen3.6-plus`            | `kimi-k2.6`       |
 
 ---
 
@@ -84,7 +84,7 @@ The following paths are denied by default:
 
 ### Simple Tasks (Q&A, intake, documentation)
 
-**Recommended:** `qwen-3.6-plus` (OpenCode Go) or `claude-haiku-4-5-20251001`
+**Recommended:** `qwen3.6-plus` (OpenCode Go) or `claude-haiku-4-5-20251001`
 (Claude)
 
 - Task Coach intake
@@ -164,7 +164,7 @@ export KIMI_API_KEY="your-key"
 | Scenario                        | Recommended                                        |
 | ------------------------------- | -------------------------------------------------- |
 | Complex reasoning, architecture | OpenCode Go (`deepseek-v4-pro`) or Claude (`opus`) |
-| Fast iteration, simple tasks    | OpenCode Go (`qwen-3.6-plus`) or Claude (`haiku`)  |
+| Fast iteration, simple tasks    | OpenCode Go (`qwen3.6-plus`) or Claude (`haiku`)   |
 | Code implementation             | OpenCode Go (`mimo-v2.5-pro`) or Claude (`sonnet`) |
 | Budget constraints              | OpenCode Go (generally lower cost)                 |
 | Availability issues             | Switch to alternative from the matrix              |

package/presets/opencode/agents/architect.md

@@ -7,7 +7,6 @@ description:
 mode: subagent
 model: "{{MODEL}}"
 temperature: 0.1
-maxTurns: 80
 tools: Read, Glob, Grep
 permission:
   read: allow

package/presets/opencode/agents/docs.md

@@ -6,7 +6,6 @@ description:
 mode: subagent
 model: "{{MODEL}}"
 temperature: 0.1
-maxTurns: 30
 tools: Read, Write, Edit, Glob, Grep
 permission:
   read: allow

package/presets/opencode/agents/implementer.md

@@ -6,7 +6,6 @@ description:
 mode: subagent
 model: "{{MODEL}}"
 temperature: 0.1
-maxTurns: 100
 tools: Read, Write, Edit, Bash, Glob, Grep
 permission:
   read: allow

package/presets/opencode/agents/orchestrator.md

@@ -7,7 +7,6 @@ description:
 mode: primary
 model: "{{MODEL}}"
 temperature: 0.1
-maxTurns: 60
 tools: Read, Glob, Grep, Bash
 permission:
   read: allow

package/presets/opencode/agents/repo-explorer.md

@@ -7,7 +7,6 @@ description:
 mode: subagent
 model: "{{MODEL}}"
 temperature: 0.1
-maxTurns: 35
 tools: Read, Glob, Grep, Bash
 permission:
   read: allow

package/presets/opencode/agents/reviewer.md

@@ -7,7 +7,6 @@ description:
 mode: subagent
 model: "{{MODEL}}"
 temperature: 0.1
-maxTurns: 40
 tools: Read, Glob, Grep, Bash
 permission:
   read: allow

package/presets/opencode/agents/task-coach.md

@@ -7,7 +7,6 @@ description:
 mode: subagent
 model: "{{MODEL}}"
 temperature: 0.1
-maxTurns: 30
 tools: Read, Glob, Grep
 permission:
   read: allow

package/presets/opencode/agents/tester.md

@@ -7,7 +7,6 @@ description:
 mode: subagent
 model: "{{MODEL}}"
 temperature: 0.1
-maxTurns: 60
 tools: Read, Write, Edit, Bash, Glob, Grep
 permission:
   read: allow

package/presets/opencode/opencode.jsonc

@@ -1,6 +1,4 @@
 {
-  // CodeConductor policies are declarative until the policy compiler exists.
-  // Enforcement depends on OpenCode permission support.
   "$schema": "https://opencode.ai/config.json",
   "model": "opencode-go/qwen3.7-max",
   "permission": {
@@ -28,9 +26,7 @@
     },
     "glob": "allow",
     "grep": "allow",
-    "external_directory": {
-      "*": "deny"
-    },
+    "external_directory": "deny",
     "bash": {
       "*": "ask",
       "git status*": "allow",
@@ -79,11 +75,6 @@
     },
     "webfetch": "ask",
     "websearch": "ask",
-    "task": {
-      "*": "ask"
-    },
-    "skill": {
-      "*": "ask"
-    }
+    "skill": "ask"
   }
 }

package/presets/opencode/prompts/v0.2.0/docs.md

@@ -8,7 +8,7 @@ description:
 | Provider | Model | Use Case |
 |----------|-------|----------|
 | Claude | claude-haiku-4-5-20251001 | Fast — documentation |
-| OpenCode Go | opencode-go/qwen-3.6-plus | Best — efficient docs |
+| OpenCode Go | opencode-go/qwen3.6-plus | Best — efficient docs |
 | OpenCode Go | opencode-go/kimi-k2.6 | Alternative |
 ---
 

package/presets/opencode/prompts/v0.2.0/repo-explorer.md

@@ -9,7 +9,7 @@ description:
 | Provider | Model | Use Case |
 |----------|-------|----------|
 | Claude | claude-haiku-4-5-20251001 | Fast — exploration |
-| OpenCode Go | opencode-go/qwen-3.6-plus | Best — quick mapping |
+| OpenCode Go | opencode-go/qwen3.6-plus | Best — quick mapping |
 | OpenCode Go | opencode-go/kimi-k2.6 | Alternative |
 ---
 

package/presets/opencode/prompts/v0.2.0/reviewer.md

@@ -9,7 +9,7 @@ description:
 | Provider | Model | Use Case |
 |----------|-------|----------|
 | Claude | claude-sonnet-4-6 | Default — code review |
-| OpenCode Go | opencode-go/qwen-3.6-plus | Best — efficient reviews |
+| OpenCode Go | opencode-go/qwen3.6-plus | Best — efficient reviews |
 | OpenCode Go | opencode-go/minimax-m2.7 | Detailed reviews |
 ---
 

package/presets/opencode/prompts/v0.2.0/task-coach.md

@@ -9,7 +9,7 @@ description:
 | Provider | Model | Use Case |
 |----------|-------|----------|
 | Claude | claude-haiku-4-5-20251001 | Fast — intake, Q&A |
-| OpenCode Go | opencode-go/qwen-3.6-plus | Best — efficient Q&A |
+| OpenCode Go | opencode-go/qwen3.6-plus | Best — efficient Q&A |
 | OpenCode Go | opencode-go/kimi-k2.6 | Alternative |
 ---
 

package/presets/seo-hotel/commands/cc-seo-audit.md

@@ -0,0 +1,87 @@
+# SEO Audit
+
+Run a comprehensive SEO and GEO audit on hotel and hospitality websites.
+
+## Usage
+
+```
+/cc-seo-audit --url <url> [--format json] [--fail-on error|warning]
+/cc-seo-audit --sitemap <sitemap-url> [--format json] [--fail-on error|warning]
+/cc-seo-audit --astro --path <src-path>
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--url` | One of `--url` or `--sitemap` | Single URL to audit |
+| `--sitemap` | One of `--url` or `--sitemap` | Remote sitemap XML URL. Only URLs listed here will be audited. |
+| `--format` | No | Output format: `cli` (default) or `json` |
+| `--fail-on` | No | Exit code trigger: `error` (default) or `warning` |
+| `--astro` | No | Run Astro-specific SEO validation on source code |
+| `--path` | With `--astro` | Path to Astro source directory |
+| `--delay` | No | Delay between requests in ms (default: 500) |
+
+## Workflow
+
+1. **Classify** the audit type:
+   - `--url` → single page audit
+   - `--sitemap` → batch audit, sitemap-scoped only
+   - `--astro` → source code validation (no network)
+
+2. **Route** to the appropriate skill(s):
+   - Schema validation → `schema-validator` skill
+   - Technical SEO → `seo-audit` skill
+   - GEO readiness → `geo-readiness` skill
+   - Astro source → `astro-seo` skill
+   - Off-page strategy → `off-page` skill
+
+3. **Execute** the audit:
+   - For `--sitemap`: fetch and parse sitemap XML, extract `<loc>` entries
+   - Validate ONLY URLs from the sitemap — never follow external links
+   - Apply rate limiting (500ms default between requests)
+   - SSRF prevention: reject private IPs and non-HTTP(S) schemes
+
+4. **Report** findings:
+   - CLI output with pass/fail/warning per check
+   - JSON output for CI/CD integration
+   - Remediation guidance with exact code snippets
+
+5. **Exit codes**:
+   - `0` = all checks passed
+   - `1` = failures found (or warnings if `--fail-on warning`)
+   - `2` = warnings only
+   - `3` = network or parsing error
+
+## Hard Rules
+
+- **Sitemap-scoped only.** When `--sitemap` is provided, only audit URLs from the sitemap.
+- **No external crawling.** Never follow hyperlinks found on pages.
+- **GET only.** No POST, PUT, DELETE requests.
+- **No auth.** Never send cookies, tokens, or API keys.
+- **Timeout.** 10 seconds per request.
+- **SSRF prevention.** Reject private IP ranges and non-HTTP(S) schemes.
+
+## Examples
+
+```bash
+# Audit a single hotel page
+/cc-seo-audit --url https://www.cantovallarta.com
+
+# Batch audit from sitemap
+/cc-seo-audit --sitemap https://www.cantovallarta.com/sitemap-0.xml
+
+# CI/CD integration
+/cc-seo-audit --sitemap https://preview.example.com/sitemap-0.xml --format json --fail-on error
+
+# Astro source code audit
+/cc-seo-audit --astro --path ./src
+```
+
+## Skills Loaded
+
+- `schema-validator` — Schema.org structured data validation
+- `seo-audit` — Technical SEO checks
+- `geo-readiness` — AI-search readiness (GEO)
+- `astro-seo` — Astro framework SEO validation
+- `off-page` — Off-page SEO strategy guidance

package/presets/seo-hotel/skills/astro-seo/SKILL.md

@@ -0,0 +1,245 @@
+---
+id: astro-seo
+version: 1.0.0
+name: Astro SEO Validator
+description: >
+  SEO validation specific to Astro framework projects. Checks static generation,
+  meta tag rendering, Content Collections usage, Island Architecture implications
+  for SEO, image optimization, sitemap generation, and Astro-specific best practices.
+
+user-invokable: true
+license: MIT
+metadata:
+  author: codeconductor
+  category: seo
+
+compatibility:
+  tools: [claude, codex, gemini, opencode]
+  stacks:
+    languages: [typescript, javascript]
+    frameworks: [astro]
+
+risk:
+  level: low
+  can_execute_shell: false
+  can_modify_files: true
+  requires_network: false
+
+inputs: []
+
+outputs:
+  - name: report
+    type: markdown
+    description: Astro-specific SEO validation report
+
+quality:
+  reviewed_by: codeconductor-core
+  version: 0.3.0
+---
+
+# Astro SEO Validator
+
+## Purpose
+
+Validate SEO best practices specific to Astro framework projects. Astro's static-first
+approach and Islands Architecture have unique SEO implications that generic tools miss.
+
+## Invocation
+
+```bash
+codeconductor seo audit-astro --path ./src
+codeconductor seo audit-astro --path ./src --format json
+```
+
+## Audit Checks
+
+### Astro Configuration
+
+| Check | Severity | Details |
+|-------|----------|---------|
+| `site` configured in astro.config | FAIL | Required for canonical URLs and sitemap |
+| `output: 'static'` or `'hybrid'` | WARNING | SSR pages need explicit caching strategy |
+| `@astrojs/sitemap` integration | FAIL | Sitemap generation is essential |
+| Image optimization enabled | WARNING | `astro:assets` or `@astrojs/image` for automatic optimization |
+| `trailingSlash` configured | SUGGESTION | Consistent URL format prevents duplicate content |
+
+### Meta Tags (Astro Components)
+
+| Check | Severity | Details |
+|-------|----------|---------|
+| `<title>` in layout | FAIL | Every page needs a title via layout or head |
+| Meta description | FAIL | Dynamic per-page descriptions |
+| Canonical URL | FAIL | Use `Astro.url` for canonical |
+| OG tags | WARNING | Open Graph for social sharing |
+| JSON-LD injection | WARNING | Structured data in `<Head>` component |
+
+### Recommended Astro SEO pattern
+
+```astro
+---
+// src/layouts/BaseLayout.astro
+interface Props {
+  title: string;
+  description: string;
+  image?: string;
+  schema?: object;
+}
+
+const canonicalURL = new URL(Astro.url.pathname, Astro.site);
+---
+
+<head>
+  <title>{title} | Canto Vallarta</title>
+  <meta name="description" content={description} />
+  <link rel="canonical" href={canonicalURL} />
+
+  <meta property="og:title" content={title} />
+  <meta property="og:description" content={description} />
+  <meta property="og:url" content={canonicalURL} />
+  <meta property="og:image" content={image ?? '/og-default.jpg'} />
+  <meta property="og:type" content="website" />
+
+  {schema && (
+    <script type="application/ld+json" set:html={JSON.stringify(schema)} />
+  )}
+</head>
+```
+
+### Content Collections
+
+| Check | Severity | Details |
+|-------|----------|---------|
+| Collections defined in `src/content/config.ts` | WARNING | Type-safe content management |
+| Content schema includes SEO fields | WARNING | title, description, image, schema fields |
+| `getCollection()` used for page generation | SUGGESTION | Static generation from collections |
+| Draft content excluded from build | WARNING | `draft: true` pages should not be published |
+
+### Recommended Content Collection schema
+
+```typescript
+// src/content/config.ts
+import { defineCollection, z } from 'astro:content';
+
+const rooms = defineCollection({
+  type: 'content',
+  schema: z.object({
+    title: z.string(),
+    description: z.string().max(160),
+    image: z.string(),
+    priceRange: z.string(),
+    amenities: z.array(z.string()),
+    schema: z.object({
+      '@type': z.literal('HotelRoom'),
+      name: z.string(),
+      occupancy: z.number(),
+    }).optional(),
+    draft: z.boolean().default(false),
+  }),
+});
+
+export const collections = { rooms };
+```
+
+### Islands Architecture SEO
+
+| Check | Severity | Details |
+|-------|----------|---------|
+| Critical content is static | FAIL | SEO-critical content must not be in client islands |
+| `<slot>` used for SEO content | WARNING | Slots render at build time |
+| `client:*` directives on non-interactive content | FAIL | Static content should not be hydrated |
+| `client:only` for third-party scripts | WARNING | Analytics, chat widgets should use `client:only` |
+
+### Anti-patterns
+
+```astro
+<!-- BAD: SEO content in client island -->
+<RoomDescription client:load />
+
+<!-- GOOD: Static SEO content, interactive elements in island -->
+<div class="room-description">
+  <Content />  <!-- Static, crawlable -->
+  <BookingWidget client:load />  <!-- Interactive, not SEO-critical -->
+</div>
+```
+
+### Image Optimization
+
+| Check | Severity | Details |
+|-------|----------|---------|
+| `<Image>` component used | WARNING | Automatic format conversion (WebP/AVIF) |
+| `width` and `height` set | FAIL | Prevents CLS |
+| `alt` text present | FAIL | Accessibility and SEO |
+| Responsive sizes configured | WARNING | `sizes` attribute for responsive images |
+| Images in public/ are optimized | WARNING | Manual images bypass Astro optimization |
+
+### Sitemap
+
+| Check | Severity | Details |
+|-------|----------|---------|
+| `@astrojs/sitemap` installed | FAIL | Required for sitemap generation |
+| Custom `serialize` function | SUGGESTION | Add hreflang, image entries |
+| Dynamic routes in sitemap | WARNING | Ensure all generated pages are included |
+| `lastmod` dates present | SUGGESTION | Helps search engines prioritize crawling |
+
+### Recommended sitemap customization
+
+```typescript
+// astro.config.ts
+import sitemap from '@astrojs/sitemap';
+
+export default defineConfig({
+  site: 'https://www.cantovallarta.com',
+  integrations: [
+    sitemap({
+      serialize(item) {
+        // Add hreflang for multilingual sites
+        item.links = [
+          { lang: 'en', url: item.url },
+          { lang: 'es', url: item.url.replace('/en/', '/es/') },
+        ];
+        return item;
+      },
+    }),
+  ],
+});
+```
+
+### Performance (Astro-specific)
+
+| Check | Severity | Details |
+|-------|----------|---------|
+| No unnecessary `client:load` | WARNING | Hydration increases JS bundle |
+| `client:visible` for below-fold islands | SUGGESTION | Lazy hydration |
+| `client:media` for viewport-dependent islands | SUGGESTION | Hydrate only at specific breakpoints |
+| View transitions configured | SUGGESTION | Astro View Transitions for SPA-like navigation |
+
+## Output Format
+
+```text
+Astro SEO Audit
+===============
+Path: ./src
+Framework: Astro 5.x
+Output mode: static
+Timestamp: 2026-05-29T06:40:00Z
+
+Configuration:
+  [FAIL]    site not configured in astro.config.ts
+  [PASS]    @astrojs/sitemap installed
+  [WARNING] output: 'server' — ensure caching strategy for SEO pages
+
+Content:
+  [PASS]    12 pages generated from content collections
+  [WARNING] 3 pages missing meta description
+
+Islands:
+  [FAIL]    RoomDescription uses client:load for SEO-critical content
+  [PASS]    BookingWidget correctly uses client:load for interactive element
+
+Images:
+  [WARNING] 8 images in public/ bypass Astro optimization
+  [FAIL]    3 images missing alt text
+
+--- Score ---
+Astro SEO: 62/100
+```