@dotdotgod/opencode 0.0.0-stage → 0.6.7

package/skills/project-initializer/templates/research.json

@@ -0,0 +1,287 @@
+{
+  "documentation": {
+    "root": "docs"
+  },
+  "memory": {
+    "areas": [
+      {
+        "id": "rules",
+        "label": "Agent Rules",
+        "paths": [
+          "AGENTS.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-working-rules",
+        "priority": 100,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "agent-entrypoint",
+        "label": "Agent Entrypoints",
+        "paths": [
+          "CLAUDE.md",
+          "CODEX.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-specific-entrypoint",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "project-overview",
+        "label": "Project Overview",
+        "paths": [
+          "README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-map",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "docs-index",
+        "label": "Docs Index",
+        "paths": [
+          "docs/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "documentation-routing-map",
+        "priority": 90,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "spec",
+        "label": "Research Specifications",
+        "paths": [
+          "docs/spec/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "research-contract",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "architecture",
+        "label": "Architecture",
+        "paths": [
+          "docs/arch/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "architecture-rationale",
+        "priority": 82,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "test",
+        "label": "Verification",
+        "paths": [
+          "docs/test/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "test-strategy",
+        "priority": 78,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "research",
+        "label": "Research Notes",
+        "paths": [
+          "docs/research/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "research-diary",
+        "priority": 70,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "record",
+        "label": "Research Records",
+        "paths": [
+          "docs/record/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "research-record",
+        "priority": 68,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "report",
+        "label": "Reports",
+        "paths": [
+          "docs/report/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "stale",
+        "role": "report-background",
+        "priority": 60,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "artifacts",
+        "label": "Generated Artifacts",
+        "paths": [
+          "outputs/**"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "artifact-body",
+        "priority": 10,
+        "includeBodiesByDefault": false
+      },
+      {
+        "id": "active-plan",
+        "label": "Active Plans",
+        "paths": [
+          "docs/plan/**"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "fresh",
+        "role": "active-task-intent",
+        "priority": 95,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-map",
+        "label": "Archive Map",
+        "paths": [
+          "docs/archive/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-map",
+        "priority": 65,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-body",
+        "label": "Archive Body",
+        "paths": [
+          "docs/archive/**"
+        ],
+        "excludePaths": [
+          "docs/archive/README.md"
+        ],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-body",
+        "priority": 20,
+        "includeBodiesByDefault": false
+      },
+      {
+        "id": "docs",
+        "label": "Project Documentation",
+        "paths": [
+          "docs/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-documentation",
+        "priority": 60,
+        "includeBodiesByDefault": true
+      }
+    ]
+  },
+  "traceability": {
+    "required": [
+      "docs/spec/**",
+      "docs/report/**"
+    ],
+    "exclude": [
+      "**/README.md"
+    ],
+    "keys": [
+      {
+        "key": "informedBy",
+        "label": "Informed by",
+        "description": "Research sources or prior findings that justify the direction.",
+        "target": "path",
+        "relation": "informed_by",
+        "weight": 4
+      },
+      {
+        "key": "assumptionsDefinedIn",
+        "label": "Assumptions defined in",
+        "description": "Documents defining assumptions that bound the claim.",
+        "target": "path",
+        "relation": "assumptions_defined_in",
+        "weight": 4
+      },
+      {
+        "key": "evaluatedBy",
+        "label": "Evaluated by",
+        "description": "Evaluation protocols or measurement methods.",
+        "target": "path",
+        "relation": "evaluated_by",
+        "weight": 4
+      },
+      {
+        "key": "evidenceRecordedIn",
+        "label": "Evidence recorded in",
+        "description": "Dated experiment, dataset, or validation records.",
+        "target": "path",
+        "relation": "evidence_recorded_in",
+        "weight": 4
+      }
+    ]
+  },
+  "validation": {
+    "markdown": {
+      "maxLines": 200,
+      "maxChars": 10000,
+      "exclude": [],
+      "filename": {
+        "warnNumberedSeries": true,
+        "allow": []
+      }
+    }
+  },
+  "impactRanking": {
+    "semantic": {
+      "enabled": true,
+      "threshold": 0.5,
+      "topKPerFile": 5
+    }
+  },
+  "referenceExpansion": {
+    "fuzzy": {
+      "lowSignal": {
+        "add": [],
+        "remove": []
+      }
+    }
+  },
+  "load": {
+    "pinnedPaths": [],
+    "pinnedBodies": [],
+    "documentationSummary": {
+      "exclude": [
+        "docs/plan",
+        "docs/archive"
+      ]
+    }
+  },
+  "planMode": {}
+}

package/skills/project-initializer/templates/software.json

@@ -0,0 +1,234 @@
+{
+  "documentation": {
+    "root": "docs"
+  },
+  "memory": {
+    "areas": [
+      {
+        "id": "rules",
+        "label": "Agent Rules",
+        "paths": [
+          "AGENTS.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-working-rules",
+        "priority": 100,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "agent-entrypoint",
+        "label": "Agent Entrypoints",
+        "paths": [
+          "CLAUDE.md",
+          "CODEX.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "agent-specific-entrypoint",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "project-overview",
+        "label": "Project Overview",
+        "paths": [
+          "README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-map",
+        "priority": 85,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "docs-index",
+        "label": "Docs Index",
+        "paths": [
+          "docs/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "documentation-routing-map",
+        "priority": 90,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "spec",
+        "label": "Product Specs",
+        "paths": [
+          "docs/spec/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "behavior-truth",
+        "priority": 80,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "architecture",
+        "label": "Architecture",
+        "paths": [
+          "docs/arch/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "architecture-rationale",
+        "priority": 75,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "test",
+        "label": "Tests",
+        "paths": [
+          "docs/test/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "verification-knowledge",
+        "priority": 70,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "active-plan",
+        "label": "Active Plans",
+        "paths": [
+          "docs/plan/**"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "fresh",
+        "role": "active-task-intent",
+        "priority": 95,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-map",
+        "label": "Archive Map",
+        "paths": [
+          "docs/archive/README.md"
+        ],
+        "excludePaths": [],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-map",
+        "priority": 65,
+        "includeBodiesByDefault": true
+      },
+      {
+        "id": "archive-body",
+        "label": "Archive Body",
+        "paths": [
+          "docs/archive/**"
+        ],
+        "excludePaths": [
+          "docs/archive/README.md"
+        ],
+        "scope": "local",
+        "freshness": "stale",
+        "role": "historical-memory-body",
+        "priority": 20,
+        "includeBodiesByDefault": false
+      },
+      {
+        "id": "docs",
+        "label": "Project Documentation",
+        "paths": [
+          "docs/**"
+        ],
+        "excludePaths": [],
+        "scope": "shared",
+        "freshness": "fresh",
+        "role": "project-documentation",
+        "priority": 60,
+        "includeBodiesByDefault": true
+      }
+    ]
+  },
+  "traceability": {
+    "required": [
+      "docs/spec/**"
+    ],
+    "exclude": [
+      "**/README.md"
+    ],
+    "keys": [
+      {
+        "key": "implementedBy",
+        "label": "Implemented by",
+        "description": "Files that implement the behavior.",
+        "target": "path",
+        "relation": "implemented_by",
+        "weight": 4
+      },
+      {
+        "key": "verifiedBy",
+        "label": "Verified by",
+        "description": "Tests or maintained verification documents.",
+        "target": "path",
+        "relation": "verified_by",
+        "weight": 4
+      },
+      {
+        "key": "relatedDocs",
+        "label": "Related docs",
+        "description": "Documents needed to interpret the behavior.",
+        "target": "path",
+        "relation": "related_doc",
+        "weight": 3
+      },
+      {
+        "key": "designDecisions",
+        "label": "Design decisions",
+        "description": "Maintained architecture or design decision documents that constrain the behavior.",
+        "target": "path",
+        "relation": "design_decision",
+        "weight": 3
+      }
+    ]
+  },
+  "validation": {
+    "markdown": {
+      "maxLines": 200,
+      "maxChars": 10000,
+      "exclude": [],
+      "filename": {
+        "warnNumberedSeries": true,
+        "allow": []
+      }
+    }
+  },
+  "impactRanking": {
+    "semantic": {
+      "enabled": true,
+      "threshold": 0.5,
+      "topKPerFile": 5
+    }
+  },
+  "referenceExpansion": {
+    "fuzzy": {
+      "lowSignal": {
+        "add": [],
+        "remove": []
+      }
+    }
+  },
+  "load": {
+    "pinnedPaths": [],
+    "pinnedBodies": [],
+    "documentationSummary": {
+      "exclude": [
+        "docs/plan",
+        "docs/archive"
+      ]
+    }
+  },
+  "planMode": {}
+}

package/skills/project-load/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: project-load
+description: Load or refresh project memory and focused documentation/code search.
+---
+
+<!-- Generated from packages/shared resources by scripts/generate-adapters.mjs. Do not edit this file directly; edit the shared source and run `pnpm run generate`. -->
+
+# Project Load
+
+Use the dotdotgod_context MCP server for project load, initialization, graph impact, execution and indexed retrieval. Discover its exact tool names in OpenCode Code Mode; inspect MCP isError and structuredContent and every execution results entry. For unknown output size use execute with a commands array and outputMode auto; search indexed.id with bounded source-scoped search. Run ancillary CLI checks through MCP execute rather than a duplicate native service. Keep direct read for short located source and images. Pending impact is advisory, never an execution gate. Preserve host permissions. Use the native plan agent, not dd:plan; concrete plans are automatically maintained in docs/plan/<task-slug>/README.md without a separate save request.
+
+## Goal
+
+Load the repository's dotdotgod project memory without modifying maintained files. Treat free-form arguments as query text, not mode switches.
+
+## Workflow
+
+1. Identify the repository root. Expose `Help: dotdotgod --help` as optional CLI discovery guidance without checking or reporting installation status, and do not require Help execution for Load to continue.
+2. When baseline context is missing, read `AGENTS.md`, the adapter entrypoint, `README.md`, and `docs/README.md` when present.
+3. Without arguments, call the shared MCP project_load tool with an empty focus and maxDepth 5. Its configured map owns documentation-root resolution, exclusions and boundary summaries.
+4. With arguments, call project_load with the arguments as focus, limit 30 and maxDepth 3. It returns the configured map plus documentation/code query results and retrieval warnings.
+5. If the CLI or shell execution is unavailable, preserve Load behavior by building the same tree from the configured documentation root when known, excluding local memory, and using README routing. At the depth boundary, list every direct Markdown file and immediate child directory, then summarize hidden descendants separately under each named child with exact recursive directory and Markdown-file counts.
+6. Query searches full documentation content and code outlines/comments, not implementation bodies. Preserve result kind, source ranges and retrieval warnings; verify source freshness before reading a symbol's implementation. Read bodies selectively from query results, explicit paths, and README indexes. Read relevant active plans only when needed, use `docs/archive/README.md` (or the configured archive `README.md` under an alternate documentation root) as the history map, and avoid broad generated, dependency, cache, or secret reads.
+
+## Output
+
+Report the project purpose, key rules, relevant documentation routes, and only the active-plan or next-read hints needed for the request. Keep compact loads to a brief refresh.

package/src/impact.mjs

@@ -0,0 +1,25 @@
+import { ImpactState, impactReminder } from '../mcp/impact-state.mjs';
+import { isLocalSession } from './location.mjs';
+
+export function editedPaths(tool, input) {
+  if (!input || typeof input !== 'object') return [];
+  if (['write', 'edit'].includes(tool)) return [input.path ?? input.filePath ?? input.file_path].filter(path => typeof path === 'string');
+  if (tool === 'patch' || tool === 'apply_patch') {
+    const patch = input.patch ?? input.patchText;
+    return typeof patch === 'string' ? [...patch.matchAll(/^\*\*\* (?:Add File|Update File|Delete File|Move to): (.+)$/gm)].map(match => match[1]) : [];
+  }
+  return [];
+}
+
+export async function registerImpact(ctx, root) {
+  await ctx.tool.hook('execute.after', async event => {
+    if (event.status !== 'completed' || !await isLocalSession(ctx, event.sessionID)) return;
+    const paths = editedPaths(event.tool, event.input);
+    if (paths.length) new ImpactState(root, event.sessionID).mark(paths);
+  });
+  await ctx.session.hook('context', async event => {
+    if (!await isLocalSession(ctx, event.sessionID)) return;
+    const reminder = impactReminder(new ImpactState(root, event.sessionID).status());
+    if (reminder) event.system.push({ type: 'text', text: reminder });
+  });
+}

package/src/index.mjs

@@ -0,0 +1,17 @@
+import { resolve } from 'node:path';
+import { registerResources } from './resources.mjs';
+import { registerMcp } from './mcp.mjs';
+import { registerPlan } from './plan.mjs';
+import { registerImpact } from './impact.mjs';
+
+export default {
+  id: 'dotdotgod',
+  async setup(ctx) {
+    // Use the active checkout, never the canonical checkout of another worktree.
+    const root = resolve(ctx.location.project.directory ?? ctx.location.directory);
+    await registerResources(ctx);
+    await registerMcp(ctx, root);
+    await registerPlan(ctx, root);
+    await registerImpact(ctx, root);
+  },
+};

package/src/location.mjs

@@ -0,0 +1,7 @@
+import { realpathSync } from 'node:fs';
+
+// Server-wide hooks can see sessions from other loaded locations.
+export async function isLocalSession(ctx, sessionID) {
+  const session = await ctx.session.get({ sessionID });
+  return realpathSync(session.location.directory) === realpathSync(ctx.location.directory);
+}

package/src/mcp.mjs

@@ -0,0 +1,37 @@
+import { fileURLToPath } from 'node:url';
+
+const prefix = 'dotdotgod_context_';
+const readOnly = new Set(['project_load', 'project_impact', 'impact_status', 'embedding_status', 'index', 'search', 'fetch_and_index', 'stats', 'doctor', 'session_resume', 'ingestion_job_start', 'ingestion_job_status']);
+const quote = value => /^[\w./:-]+$/.test(String(value)) ? String(value) : `'${String(value).replaceAll("'", "'\\''")}'`;
+
+export async function registerMcp(ctx, root) {
+  await ctx.mcp.transform(editor => {
+    if (editor.get('dotdotgod_context')) return;
+    editor.set('dotdotgod_context', {
+      type: 'local', command: ['node', fileURLToPath(new URL('../mcp/server.mjs', import.meta.url))],
+      cwd: root, environment: { DOTDOTGOD_PROJECT_ROOT: root }, codemode: true,
+    });
+  });
+  await ctx.tool.transform(editor => {
+    for (const tool of editor.list()) {
+      if (!tool.id.startsWith(prefix)) continue;
+      editor.update(tool.id, draft => {
+        const execute = draft.execute;
+        const name = tool.id.slice(prefix.length);
+        draft.execute = async (input, context) => {
+          // Actual executor context, not model-selected session identity. This
+          // wrapper also runs when the tool is called through Code Mode.
+          if (context.agent === 'plan' && !readOnly.has(name)) throw new Error('Plan mode: this write-capable MCP operation requires switching agents.');
+          if (name === 'execute') {
+            for (const entry of input.commands ?? []) await ctx.permission.assert({
+              sessionID: context.sessionID, agent: context.agent,
+              source: { type: 'tool', messageID: context.messageID, id: context.id },
+              action: 'shell', resources: [entry.executable ? [entry.executable, ...(entry.args ?? [])].map(quote).join(' ') : entry.command ?? ''],
+            });
+          }
+          return execute({ ...input, contextSessionId: context.sessionID }, context);
+        };
+      });
+    }
+  });
+}