anymorph 0.4.0 → 0.5.0

package/dist/skillpacks/geo/skills/geo-generating-actions/scripts/geo-scaffold.mjs

@@ -1,358 +0,0 @@
-#!/usr/bin/env node
-import { execFile } from "node:child_process";
-import { createHash } from "node:crypto";
-import {
-	cp,
-	mkdir,
-	readdir,
-	readFile,
-	rm,
-	stat,
-	writeFile,
-} from "node:fs/promises";
-import { dirname, join, relative, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { promisify } from "node:util";
-
-const execFileAsync = promisify(execFile);
-const MANAGED_PATHS = [".claude/skills", ".agents/skills", "agent/contracts"];
-const ACTIONS_SCHEMA = {
-	$schema: "https://json-schema.org/draft/2020-12/schema",
-	title: "Anymorph GEO actions artifact",
-	type: "object",
-	required: ["runId", "actions"],
-	properties: {
-		runId: { type: "string" },
-		actions: { type: "array", items: { type: "object" } },
-		artifactPaths: { type: "array", items: { type: "string" } },
-	},
-};
-
-const MEMORY_ITEM_SCHEMA = {
-	$schema: "https://json-schema.org/draft/2020-12/schema",
-	title: "Anymorph GEO memory item",
-	type: "object",
-	required: ["summary"],
-	properties: {
-		summary: { type: "string" },
-		evidence: { type: "array", items: { type: "string" } },
-	},
-};
-
-const mode = process.argv[2];
-const args = parseArgs(process.argv.slice(3));
-
-if (!["init", "sync", "doctor"].includes(mode)) {
-	console.error("Usage: geo-scaffold.mjs <init|sync|doctor> --repo <path> [--skills-source <path>] [--ref <ref>] [--json]");
-	process.exit(2);
-}
-
-try {
-	const result =
-		mode === "doctor"
-			? await doctorGeoScaffold(args)
-			: await applyGeoScaffold(args, { createMemory: mode === "init" });
-
-	if (args.json) {
-		console.log(JSON.stringify(result, null, 2));
-	} else if (result.ok) {
-		console.log(`${mode} ok: ${result.repoPath}`);
-		for (const item of result.changed) console.log(`changed: ${item}`);
-	} else {
-		console.error(`${mode} failed: ${result.repoPath}`);
-		for (const problem of result.problems) console.error(`problem: ${problem}`);
-	}
-	process.exit(args.json ? 0 : result.ok ? 0 : 1);
-} catch (err) {
-	const message = err instanceof Error ? err.message : String(err);
-	if (args.json) {
-		console.log(
-			JSON.stringify(
-				{
-					ok: false,
-					repoPath: resolve(args.repo ?? "."),
-					skillsSourceDir: args.skillsSource ? resolve(args.skillsSource) : defaultSkillsSourceDir(),
-					changed: [],
-					problems: [message],
-					manifestHash: null,
-				},
-				null,
-				2,
-			),
-		);
-	} else {
-		console.error(message);
-	}
-	process.exit(1);
-}
-
-function parseArgs(argv) {
-	const parsed = { repo: ".", ref: "local", json: false };
-	for (let i = 0; i < argv.length; i += 1) {
-		const arg = argv[i];
-		if (arg === "--json") parsed.json = true;
-		else if (arg === "--repo") parsed.repo = requireValue(argv, ++i, arg);
-		else if (arg === "--skills-source") parsed.skillsSource = requireValue(argv, ++i, arg);
-		else if (arg === "--ref") parsed.ref = requireValue(argv, ++i, arg);
-		else if (arg === "--script-version") parsed.scriptVersion = requireValue(argv, ++i, arg);
-		else if (arg === "--cli-version") parsed.scriptVersion = requireValue(argv, ++i, arg);
-		else throw new Error(`Unknown argument: ${arg}`);
-	}
-	return parsed;
-}
-
-function requireValue(argv, index, flag) {
-	const value = argv[index];
-	if (!value || value.startsWith("--")) throw new Error(`${flag} requires a value`);
-	return value;
-}
-
-async function applyGeoScaffold(input, options) {
-	const repoPath = resolve(input.repo ?? ".");
-	const skillsSourceDir = resolveSkillsSourceDir(input.skillsSource);
-	await ensureDirectory(skillsSourceDir);
-	await mkdir(repoPath, { recursive: true });
-
-	const changed = [];
-	const problems = [];
-	const manifestHash = await hashDirectory(skillsSourceDir);
-
-	await syncManagedDirectory(skillsSourceDir, join(repoPath, ".claude", "skills"), changed);
-	await syncManagedDirectory(skillsSourceDir, join(repoPath, ".agents", "skills"), changed);
-	await syncContracts(repoPath, changed);
-	await ensureRunDirs(repoPath, changed);
-	if (options.createMemory) await ensureMemoryFiles(repoPath, changed);
-	await writeSkillpackLock(
-		{
-			repoPath,
-			skillsSourceDir,
-			ref: input.ref ?? "local",
-			manifestHash,
-			scriptVersion: input.scriptVersion ?? null,
-		},
-		changed,
-	);
-
-	return {
-		ok: problems.length === 0,
-		repoPath,
-		skillsSourceDir,
-		changed,
-		problems,
-		manifestHash,
-	};
-}
-
-async function doctorGeoScaffold(input) {
-	const repoPath = resolve(input.repo ?? ".");
-	const skillsSourceDir = resolveSkillsSourceDir(input.skillsSource);
-	await ensureDirectory(skillsSourceDir);
-	const manifestHash = await hashDirectory(skillsSourceDir);
-	const problems = [];
-
-	for (const target of [".claude/skills", ".agents/skills"]) {
-		await compareDirectories(skillsSourceDir, join(repoPath, target), target, problems);
-	}
-	for (const path of [
-		"agent/BRAND.md",
-		"agent/STRATEGY.md",
-		"agent/LEARNINGS.md",
-		"agent/runs/.gitkeep",
-		"agent/archive/.gitkeep",
-		"agent/skillpack.json",
-	]) {
-		if (!(await exists(join(repoPath, path)))) problems.push(`Missing ${path}`);
-	}
-
-	const lock = await readJson(join(repoPath, "agent", "skillpack.json"));
-	if (lock && typeof lock === "object" && lock.manifestHash !== manifestHash) {
-		problems.push("agent/skillpack.json manifestHash does not match current skillpack");
-	}
-
-	return {
-		ok: problems.length === 0,
-		repoPath,
-		skillsSourceDir,
-		changed: [],
-		problems,
-		manifestHash,
-	};
-}
-
-function resolveSkillsSourceDir(explicit) {
-	if (explicit) return resolve(explicit);
-	return defaultSkillsSourceDir();
-}
-
-function defaultSkillsSourceDir() {
-	const scriptDir = dirname(fileURLToPath(import.meta.url));
-	return resolve(scriptDir, "..", "..");
-}
-
-async function syncManagedDirectory(sourceDir, targetDir, changed) {
-	const source = resolve(sourceDir);
-	const target = resolve(targetDir);
-	if (source === target) {
-		return;
-	}
-	if (source.startsWith(`${target}/`)) {
-		throw new Error(`Refusing to sync ${source} into itself at ${target}`);
-	}
-	await rm(target, { recursive: true, force: true });
-	await mkdir(dirname(target), { recursive: true });
-	await cp(source, target, { recursive: true });
-	changed.push(relative(process.cwd(), target) || target);
-}
-
-async function syncContracts(repoPath, changed) {
-	const contractsDir = join(repoPath, "agent", "contracts");
-	await mkdir(contractsDir, { recursive: true });
-	await writeIfChanged(
-		join(contractsDir, "actions.schema.json"),
-		`${JSON.stringify(ACTIONS_SCHEMA, null, 2)}\n`,
-		changed,
-	);
-	await writeIfChanged(
-		join(contractsDir, "memory-item.schema.json"),
-		`${JSON.stringify(MEMORY_ITEM_SCHEMA, null, 2)}\n`,
-		changed,
-	);
-}
-
-async function ensureRunDirs(repoPath, changed) {
-	for (const path of [join(repoPath, "agent", "runs"), join(repoPath, "agent", "archive")]) {
-		await mkdir(path, { recursive: true });
-		await writeIfMissing(join(path, ".gitkeep"), "", changed);
-	}
-}
-
-async function ensureMemoryFiles(repoPath, changed) {
-	await mkdir(join(repoPath, "agent"), { recursive: true });
-	await writeIfMissing(
-		join(repoPath, "agent", "BRAND.md"),
-		"# Brand\n\nInitial local scaffold. Replace with workspace brand context before serious runs.\n",
-		changed,
-	);
-	await writeIfMissing(
-		join(repoPath, "agent", "STRATEGY.md"),
-		"# GEO Strategy\n\n## Current Priorities\n\n- Initial local scaffold.\n",
-		changed,
-	);
-	await writeIfMissing(
-		join(repoPath, "agent", "LEARNINGS.md"),
-		"# Learnings\n\n## Stable Learnings\n\n- Initial local scaffold.\n",
-		changed,
-	);
-}
-
-async function writeSkillpackLock(input, changed) {
-	const sourceCommit = await gitOutput(input.skillsSourceDir, ["rev-parse", "HEAD"]);
-	const lock = {
-		name: "anymorph-geo",
-		source: input.skillsSourceDir,
-		sourceRepo: "opactor-dev/anymorph-geo-skills",
-		requestedRef: input.ref,
-		resolvedCommit: sourceCommit,
-		scriptVersion: input.scriptVersion,
-		manifestHash: input.manifestHash,
-		installedAt: new Date().toISOString(),
-		managedPaths: MANAGED_PATHS,
-	};
-	await writeIfChanged(
-		join(input.repoPath, "agent", "skillpack.json"),
-		`${JSON.stringify(lock, null, 2)}\n`,
-		changed,
-	);
-}
-
-async function compareDirectories(sourceDir, targetDir, displayPrefix, problems) {
-	const sourceFiles = await listFiles(sourceDir);
-	const targetFiles = await listFiles(targetDir);
-	const targetSet = new Set(targetFiles);
-	for (const file of sourceFiles) {
-		const source = await readFile(join(sourceDir, file), "utf8");
-		const targetPath = join(targetDir, file);
-		if (!(await exists(targetPath))) {
-			problems.push(`Missing ${displayPrefix}/${file}`);
-			continue;
-		}
-		const target = await readFile(targetPath, "utf8");
-		if (source !== target) problems.push(`Drifted ${displayPrefix}/${file}`);
-		targetSet.delete(file);
-	}
-	for (const extra of targetSet) problems.push(`Extra managed file ${displayPrefix}/${extra}`);
-}
-
-async function hashDirectory(dir) {
-	const files = await listFiles(dir);
-	const hash = createHash("sha256");
-	for (const file of files) {
-		hash.update(file);
-		hash.update("\0");
-		hash.update(await readFile(join(dir, file)));
-		hash.update("\0");
-	}
-	return `sha256:${hash.digest("hex")}`;
-}
-
-async function listFiles(dir, base = "") {
-	let entries;
-	try {
-		entries = await readdir(join(dir, base), { withFileTypes: true });
-	} catch {
-		return [];
-	}
-	const files = [];
-	for (const entry of entries) {
-		const name = String(entry.name);
-		const path = base ? `${base}/${name}` : name;
-		if (entry.isDirectory()) files.push(...(await listFiles(dir, path)));
-		else if (entry.isFile()) files.push(path);
-	}
-	return files.sort();
-}
-
-async function writeIfMissing(path, content, changed) {
-	if (await exists(path)) return;
-	await mkdir(dirname(path), { recursive: true });
-	await writeFile(path, content);
-	changed.push(relative(process.cwd(), path) || path);
-}
-
-async function writeIfChanged(path, content, changed) {
-	const current = await readFile(path, "utf8").catch(() => null);
-	if (current === content) return;
-	await mkdir(dirname(path), { recursive: true });
-	await writeFile(path, content);
-	changed.push(relative(process.cwd(), path) || path);
-}
-
-async function readJson(path) {
-	const raw = await readFile(path, "utf8").catch(() => null);
-	if (!raw) return null;
-	try {
-		return JSON.parse(raw);
-	} catch {
-		return null;
-	}
-}
-
-async function gitOutput(cwd, args) {
-	try {
-		const { stdout } = await execFileAsync("git", args, { cwd });
-		return stdout.trim() || null;
-	} catch {
-		return null;
-	}
-}
-
-async function ensureDirectory(path) {
-	const s = await stat(path);
-	if (!s.isDirectory()) throw new Error(`${path} is not a directory`);
-}
-
-async function exists(path) {
-	return stat(path)
-		.then(() => true)
-		.catch(() => false);
-}

package/dist/skillpacks/geo/skills/geo-generating-actions/scripts/geo.mjs

@@ -1,66 +0,0 @@
-#!/usr/bin/env node
-import { spawn } from "node:child_process";
-
-const legacyCommand = process.argv[2];
-const legacyArgs = process.argv.slice(3);
-
-const commandMap = new Map([
-	["materialize", "submit"],
-	["check", "doctor"],
-	["sync", "doctor"],
-]);
-
-if (!legacyCommand || ["-h", "--help", "help"].includes(legacyCommand)) {
-	usage();
-	process.exit(0);
-}
-
-if (legacyArgs.includes("--repo")) {
-	console.error(
-		"`--repo` is no longer supported. Run `anymorph` from the tenant repo root instead.",
-	);
-	process.exit(2);
-}
-
-const command = commandMap.get(legacyCommand) ?? legacyCommand;
-const args = legacyArgs.filter((arg) => !arg.startsWith("--repo="));
-if (legacyCommand === "sync") args.unshift("--fix");
-
-console.error(
-	"`geo.mjs` is deprecated. Use the top-level Anymorph CLI: " +
-		`anymorph ${[command, ...args].join(" ")}`.trim(),
-);
-
-const child = spawn("anymorph", [command, ...args], {
-	stdio: "inherit",
-	env: process.env,
-});
-
-child.on("exit", (code, signal) => {
-	if (signal) {
-		process.kill(process.pid, signal);
-		return;
-	}
-	process.exit(code ?? 1);
-});
-
-child.on("error", (err) => {
-	console.error(`Could not run \`anymorph\`: ${err.message}`);
-	process.exit(1);
-});
-
-function usage() {
-	console.error(`Usage:
-  anymorph login
-  anymorph logout
-  anymorph status
-  anymorph workspaces
-  anymorph init
-  anymorph doctor
-  anymorph doctor --fix
-  anymorph prepare <workspaceId>
-  anymorph validate <runId>
-  anymorph submit <runId>
-  anymorph intents <runId>
-  anymorph run-status <runId>`);
-}

package/dist/skillpacks/geo/skills/geo-initializing-strategy/SKILL.md

@@ -1,50 +0,0 @@
----
-name: geo-initializing-strategy
-description: Use when creating or repairing the initial Strategy Map baseline for an Anymorph workspace before recurring GEO action generation begins.
----
-
-# GEO Initializing Strategy
-
-Use this skill to create the first durable Strategy Map for a tenant.
-
-This is a baseline skill, not an action-generation skill. It diagnoses the workspace's owned-site foundation, visibility state, semantic clusters, and external authority so later GEO loops have a stable operating plan.
-
-## Required Inputs
-
-- Tenant repository path.
-- `workspaceId` for internal MCP calls.
-- Host-created Strategy Map context and manifest files.
-- Existing tenant memory files when present:
-  - `agent/BRAND.md`
-  - `agent/STRATEGY.md`
-  - `agent/LEARNINGS.md`
-
-## Workflow
-
-1. Read the host context and manifest first.
-2. Read existing tenant memory before using external evidence.
-3. Use Strategy Map diagnoses for foundation, visibility, semantic clusters, and external authority.
-4. Treat diagnosis section JSON files as the source of truth after they are submitted.
-5. Synthesize a long-term strategy with investment mix, active bets, guardrails, and open strategic questions.
-6. Rewrite `agent/STRATEGY.md` as the canonical human-readable Strategy Map.
-7. Submit structured Strategy Map artifacts through the runtime artifact tools; do not write structured JSON artifacts directly.
-
-## Contracts
-
-Read these references only when needed:
-
-- `references/memory-contract.md` for tenant memory file requirements.
-- `references/strategy-map-contract.md` for output boundaries and quality bar.
-- `references/foundation-diagnosis.md` for owned-site foundation diagnosis.
-- `references/visibility-diagnosis.md` for AI visibility baseline diagnosis.
-- `references/semantic-clusters-diagnosis.md` for semantic cluster diagnosis.
-- `references/external-authority-diagnosis.md` for external authority diagnosis.
-
-## Guardrails
-
-- Preserve YAML frontmatter on existing tenant memory files.
-- Never write empty frontmatter.
-- Do not generate weekly actions, page briefs, outreach tasks, or execution steps.
-- Prefer `unknown` or omitted optional fields over invented certainty.
-- Exclude Anymorph-generated GEO pages from owned-site foundation evidence.
-- Do not edit `agent/BRAND.md`; raise brand drift in rationale instead.

package/dist/skillpacks/geo/skills/geo-initializing-strategy/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "GEO Initializing Strategy"
-  short_description: "Create the initial Strategy Map baseline for a workspace."
-  default_prompt: "Use $geo-initializing-strategy to create the initial Strategy Map baseline for this workspace."

package/dist/skillpacks/geo/skills/geo-initializing-strategy/references/external-authority-diagnosis.md

@@ -1,66 +0,0 @@
-# Strategy Map: External Authority Diagnosis
-
-Summarize external authority by surface class:
-
-- Reddit
-- YouTube
-- Wikipedia/Wikidata
-- review platforms
-- directories
-- publications
-- forums
-- podcasts
-- newsletters
-- social
-- other
-
-Capture tenant presence, competitor presence, relevance, actionability, and strategic implication.
-
-Do not include outreach copy, posts, scripts, or tactical execution steps.
-
-Use DataForSEO as the primary paid source for backlink and referring-domain evidence. Prefer `mcp__anymorph__dataforseo_research` for:
-
-- `/v3/backlinks/summary/live`
-- `/v3/backlinks/referring_domains/live`
-- `/v3/backlinks/backlinks/live`
-- `/v3/dataforseo_labs/google/domain_rank_overview/live`
-
-Ahrefs is not required for this section.
-
-Keep web research bounded:
-
-- Use at most 6 `mcp__anymorph__web_search` calls.
-- Use `mcp__anymorph__summarized_web_scrape` only for the highest-signal pages that change the diagnosis.
-- Prefer citation tools before broad web search.
-
-Never emit `null`. Omit optional fields when unknown. Required unknown enum fields must use `unknown`.
-
-Submit exactly one section artifact with `mcp__strategy_map_artifacts__submit_strategy_map_section`.
-
-```json
-{
-  "section": "externalAuthority",
-  "artifact": [
-    {
-      "id": "auth-short-stable-id",
-      "surfaceClass": "reddit | youtube | wikipedia_wikidata | review_platform | directory | publication | forum | podcast | newsletter | social | other",
-      "relevance": "high | medium | low | unknown",
-      "tenantPresence": "strong | medium | weak | absent | unknown",
-      "competitorPresence": "strong | medium | weak | absent | unknown",
-      "actionability": "high | medium | low | none | unknown",
-      "strategicImplication": "What this authority state means for the roadmap.",
-      "evidenceRefs": ["ev-authority-1"]
-    }
-  ],
-  "evidence": [
-    {
-      "id": "ev-authority-1",
-      "type": "signal | workspace | source | research",
-      "ref": "tool or source reference",
-      "summary": "Specific evidence summary."
-    }
-  ]
-}
-```
-
-Final response: one short sentence naming the saved section.

package/dist/skillpacks/geo/skills/geo-initializing-strategy/references/foundation-diagnosis.md

@@ -1,86 +0,0 @@
-# Strategy Map: Foundation Diagnosis
-
-Diagnose the technical SEO/GEO foundation.
-
-Focus only on durable strategic signals:
-
-- indexability
-- crawlability
-- schema/content parity
-- AI crawler access
-- internal linking
-- page experience
-
-Do not emit page-level fixes, implementation briefs, or action lists.
-
-Use `mcp__anymorph__dataforseo_onpage` as the primary owned-site crawl and internal-link evidence source.
-
-Baseline rule:
-
-- Foundation is the existing brand-owned site baseline.
-- Exclude Anymorph-generated GEO pages from owned-page, internal-link hub, inbound-link, orphan-page, and crawl-state judgments.
-- Pass `workspaceId` to `dataforseo_onpage`; backend will remove generated GEO pages from DFS pages/links results.
-- Generated GEO pages may be mentioned only as strategy execution surfaces in semantic/visibility synthesis, not as Foundation evidence.
-
-Expected DataForSEO On-Page flow:
-
-1. `action=start_crawl`, `target=<workspace domain>`, `workspaceId=<workspace id>`, `maxCrawlPages` around 100.
-2. `action=summary` with the returned `taskId`, `workspaceId=<workspace id>`.
-3. If the crawl is finished, call `action=pages` ordered by `meta.inbound_links_count,desc`, with `workspaceId=<workspace id>`.
-4. Call `action=links` with `direction=internal`, `dofollowOnly=true`, `workspaceId=<workspace id>`.
-
-Use these DFS fields:
-
-- `status_code` and `page_to_status_code` for crawl/indexability evidence.
-- `meta.internal_links_count`, `meta.inbound_links_count`, and `checks.is_orphan_page` for internal-link topology.
-- `page_from`, `page_to`, `link_from`, `link_to`, and `dofollow` for edge evidence.
-
-Do not use DataForSEO Backlinks API as a substitute for owned-site internal-link evidence. Use DataForSEO On-Page only.
-
-Do not claim a page is an in-content hub from DFS alone. DFS On-Page can show internal edges and target status, but not guaranteed nav/footer/content placement. For true in-content hub claims, corroborate with page content or page HTML via `get_page_content` or summarized scrape.
-
-Use Ahrefs only as optional enrichment for crawl and in-content internal-link evidence. For internal-link hubs, filter to in-content, dofollow links when the endpoint supports it. If Ahrefs returns "API units limit reached", times out, fails auth, or is unavailable, stop calling Ahrefs and continue with DataForSEO On-Page + owned-source evidence.
-
-Use `mcp__anymorph__summarized_web_scrape` by its full tool name. Do not call a bare `mcp__summarized_web_scrape`.
-
-Never emit `null`. Omit optional fields when unknown. Required unknown enum fields must use `unknown`.
-
-Submit exactly one section artifact with `mcp__strategy_map_artifacts__submit_strategy_map_section`.
-
-```json
-{
-  "section": "foundation",
-  "artifact": {
-    "status": "strong | medium | weak | unknown",
-    "signals": {
-      "indexability": "strong | medium | weak | unknown",
-      "crawlability": "strong | medium | weak | unknown",
-      "schemaParity": "strong | medium | weak | unknown",
-      "aiCrawlerAccess": "strong | medium | weak | unknown",
-      "internalLinking": "strong | medium | weak | unknown",
-      "pageExperience": "strong | medium | weak | unknown"
-    },
-    "blockers": [
-      {
-        "id": "blk-short-stable-id",
-        "type": "indexability | crawlability | schema_parity | ai_crawler_access | internal_linking | page_experience | faceted_navigation | duplicate_content | rendering | other",
-        "severity": "high | medium | low",
-        "summary": "Strategic blocker, not a page-level fix brief.",
-        "evidenceRefs": ["ev-foundation-1"]
-      }
-    ],
-    "strategicImplication": "What this foundation state means for long-term investment mix.",
-    "evidenceRefs": ["ev-foundation-1"]
-  },
-  "evidence": [
-    {
-      "id": "ev-foundation-1",
-      "type": "signal | workspace | source | research",
-      "ref": "tool or source reference",
-      "summary": "Specific evidence summary."
-    }
-  ]
-}
-```
-
-Final response: one short sentence naming the saved section.

package/dist/skillpacks/geo/skills/geo-initializing-strategy/references/memory-contract.md

@@ -1,15 +0,0 @@
-# Tenant Memory Contract
-
-Durable tenant memory lives in the tenant repository.
-
-- `agent/BRAND.md`: brand facts regenerated by backend; read-only during Strategy Map runs.
-- `agent/STRATEGY.md`: canonical human-readable Strategy Map.
-- `agent/LEARNINGS.md`: stable repeated observations only.
-
-Rules:
-
-- Keep frontmatter present and non-empty.
-- Preserve existing frontmatter keys unless the run has explicit reason to update them.
-- Keep memory concise.
-- Do not paste raw evidence, generic SEO advice, or long research transcripts.
-- Put run-specific details under `agent/strategy-map/runs/{runId}/`.