anymorph 0.4.0 → 0.5.0

package/dist/skillpacks/geo/skills/geo-page-writer/scripts/collect-page-sources.mjs

@@ -1,303 +0,0 @@
-#!/usr/bin/env node
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join, resolve } from "node:path";
-
-const CONFIG_DIR = join(homedir(), ".anymorph");
-const CRED_FILE = join(CONFIG_DIR, "credentials.json");
-
-const command = process.argv[2];
-const args = parseArgs(process.argv.slice(3));
-
-try {
-	const result = await run(command, args);
-	if (result !== undefined) console.log(JSON.stringify(result, null, 2));
-	if (result && result.ok === false) process.exitCode = 1;
-} catch (err) {
-	const message = err instanceof Error ? err.message : String(err);
-	console.error(message);
-	process.exit(1);
-}
-
-async function run(mode, input) {
-	if (mode === "exa") return collectExa(input);
-	if (mode === "kb") return collectKb(input);
-	if (mode === "images") return collectImages(input);
-	if (mode === "all") return collectAll(input);
-	throw new Error("Usage: collect-page-sources.mjs <exa|kb|images|all> --run-id <id> --action-id <id> --workspace <id-or-domain> [--repo .] [--query text]");
-}
-
-function parseArgs(argv) {
-	const out = { repo: ".", limit: "10", imageLimit: "10" };
-	for (let i = 0; i < argv.length; i += 1) {
-		const arg = argv[i];
-		if (arg === "--repo") out.repo = requireValue(argv, ++i, arg);
-		else if (arg === "--run-id") out.runId = requireValue(argv, ++i, arg);
-		else if (arg === "--action-id") out.actionId = requireValue(argv, ++i, arg);
-		else if (arg === "--workspace") out.workspace = requireValue(argv, ++i, arg);
-		else if (arg === "--query") out.query = requireValue(argv, ++i, arg);
-		else if (arg === "--limit") out.limit = requireValue(argv, ++i, arg);
-		else if (arg === "--image-limit") out.imageLimit = requireValue(argv, ++i, arg);
-		else if (arg === "--type") out.type = requireValue(argv, ++i, arg);
-		else throw new Error(`Unknown argument: ${arg}`);
-	}
-	return out;
-}
-
-function requireValue(argv, index, flag) {
-	const value = argv[index];
-	if (!value || value.startsWith("--")) throw new Error(`${flag} requires a value`);
-	return value;
-}
-
-async function collectAll(input) {
-	const results = { exa: null, kb: null, images: null, failures: [] };
-	for (const [key, fn] of [
-		["exa", collectExa],
-		["kb", collectKb],
-		["images", collectImages],
-	]) {
-		try {
-			results[key] = await fn({ ...input, quiet: true });
-		} catch (err) {
-			results.failures.push({ source: key, error: err instanceof Error ? err.message : String(err) });
-		}
-	}
-	const ctx = await loadContext(input);
-	const sourcesDir = await ensureSourcesDir(ctx);
-	const sourcePack = {
-		schemaVersion: 1,
-		runId: ctx.runId,
-		actionId: ctx.actionId,
-		workspace: ctx.workspace,
-		query: ctx.query,
-		action: ctx.action,
-		generatedAt: new Date().toISOString(),
-		exa: results.exa?.summary ?? null,
-		exaSources: results.exa?.sources ?? [],
-		kb: results.kb?.summary ?? null,
-		kbResults: results.kb?.results ?? [],
-		images: results.images?.summary ?? null,
-		imageResults: results.images?.results ?? [],
-		failures: results.failures,
-	};
-	await writeJson(join(sourcesDir, "source-pack.json"), sourcePack);
-	return { ok: results.failures.length === 0, dir: sourcesDir, sourcePack: join(sourcesDir, "source-pack.json"), failures: results.failures };
-}
-
-async function collectExa(input) {
-	const apiKey = process.env.EXA_API_KEY;
-	if (!apiKey) throw new Error("EXA_API_KEY is required for Exa Deep Search");
-	const ctx = await loadContext(input);
-	const sourcesDir = await ensureSourcesDir(ctx);
-	const body = {
-		query: buildResearchPrompt(ctx),
-		type: input.type ?? "deep-reasoning",
-		contents: { highlights: true, summary: true },
-	};
-	const res = await fetch("https://api.exa.ai/search", {
-		method: "POST",
-		headers: {
-			"Content-Type": "application/json",
-			"x-api-key": apiKey,
-		},
-		body: JSON.stringify(body),
-	});
-	const text = await res.text();
-	if (!res.ok) throw new Error(`Exa search failed (${res.status}): ${text.slice(0, 1000)}`);
-	const data = JSON.parse(text);
-	const markdown = renderExaMarkdown(ctx, data);
-	await writeFile(join(sourcesDir, "exa-research.md"), markdown);
-	await writeJson(join(sourcesDir, "exa-response.json"), data);
-	const summary = {
-		type: body.type,
-		resultCount: Array.isArray(data.results) ? data.results.length : 0,
-		hasOutput: Boolean(data.output),
-		costDollars: data.costDollars ?? null,
-	};
-	return {
-		ok: true,
-		dir: sourcesDir,
-		summary,
-		sources: (data.results ?? []).map((item) => ({
-			title: item.title ?? null,
-			url: item.url ?? null,
-			publishedDate: item.publishedDate ?? null,
-		})),
-	};
-}
-
-async function collectKb(input) {
-	const ctx = await loadContext(input);
-	const workspaceId = await resolveWorkspaceId(ctx.workspace);
-	const sourcesDir = await ensureSourcesDir(ctx);
-	const params = new URLSearchParams({ query: ctx.query });
-	const data = await backendJson("GET", `/api/workspaces/${encodeURIComponent(workspaceId)}/knowledge-base/search?${params}`);
-	await writeJson(join(sourcesDir, "kb-results.json"), data);
-	const summary = {
-		workspaceId,
-		resultCount: Array.isArray(data.results) ? data.results.length : 0,
-	};
-	return { ok: true, dir: sourcesDir, summary, results: data.results ?? [] };
-}
-
-async function collectImages(input) {
-	const ctx = await loadContext(input);
-	const workspaceId = await resolveWorkspaceId(ctx.workspace);
-	const sourcesDir = await ensureSourcesDir(ctx);
-	const params = new URLSearchParams({
-		q: ctx.query,
-		topK: String(Number(input.imageLimit ?? input.limit ?? 10)),
-	});
-	const data = await backendJson("GET", `/api/workspaces/${encodeURIComponent(workspaceId)}/image-assets/search?${params}`);
-	await writeJson(join(sourcesDir, "image-results.json"), data);
-	const rows = Array.isArray(data.results) ? data.results : Array.isArray(data.items) ? data.items : [];
-	const summary = { workspaceId, resultCount: rows.length };
-	return { ok: true, dir: sourcesDir, summary, results: rows };
-}
-
-async function loadContext(input) {
-	const repo = resolve(input.repo ?? ".");
-	const runId = required(input.runId, "--run-id");
-	const actionId = required(input.actionId, "--action-id");
-	const runDir = join(repo, "agent", "runs", runId);
-	const actions = await readJson(join(runDir, "actions.json"));
-	const context = await readJson(join(runDir, "context.json")).catch(() => null);
-	const action = actions.actions?.find((item) => item.id === actionId);
-	if (!action) throw new Error(`Action ${actionId} not found in agent/runs/${runId}/actions.json`);
-	if (action.assetType !== "geo_page") throw new Error(`Action ${actionId} is ${action.assetType}; geo-page-writer only supports geo_page actions`);
-	const workspace = input.workspace ?? context?.workspaceId ?? context?.workspaceDomain;
-	if (!workspace) throw new Error("--workspace is required when run context does not include workspaceId/workspaceDomain");
-	const query = input.query ?? buildDefaultQuery(action, context);
-	return { repo, runId, actionId, runDir, action, context, workspace, query };
-}
-
-function buildDefaultQuery(action, context) {
-	const target = action.target ?? {};
-	return [
-		target.title,
-		action.objective,
-		action.changeBrief,
-		action.reason,
-		Array.isArray(target.queryCluster) ? target.queryCluster.join(", ") : "",
-		context?.workspaceDomain ? `brand domain: ${context.workspaceDomain}` : "",
-	]
-		.filter(Boolean)
-		.join("\n");
-}
-
-function buildResearchPrompt(ctx) {
-	return [
-		"Research this GEO page before MDX writing.",
-		"Return concise findings, source URLs, caveats, and claims that are safe to cite.",
-		"",
-		`Workspace: ${ctx.workspace}`,
-		`Run: ${ctx.runId}`,
-		`Action: ${ctx.actionId}`,
-		`Objective: ${ctx.action.objective}`,
-		`Reason: ${ctx.action.reason}`,
-		`Brief: ${ctx.action.changeBrief}`,
-		`Expected outcome: ${ctx.action.expectedOutcome}`,
-		"",
-		`Research query:\n${ctx.query}`,
-	].join("\n");
-}
-
-function renderExaMarkdown(ctx, data) {
-	const lines = [
-		`# Exa Research: ${ctx.action.target?.title ?? ctx.action.objective}`,
-		"",
-		`Run: ${ctx.runId}`,
-		`Action: ${ctx.actionId}`,
-		`Generated: ${new Date().toISOString()}`,
-		"",
-		"## Synthesized Output",
-		"",
-		renderOutputContent(data.output?.content),
-		"",
-		"## Grounding",
-		"",
-		...(Array.isArray(data.output?.grounding)
-			? data.output.grounding.map((item) => `- ${item.field ?? "output"}: ${(item.citations ?? []).map((c) => `${c.title ?? c.url} (${c.url})`).join("; ")}${item.confidence ? ` [${item.confidence}]` : ""}`)
-			: ["- none"]),
-		"",
-		"## Results",
-		"",
-		...(Array.isArray(data.results)
-			? data.results.map((item) => `- ${item.title ?? item.url}\n  ${item.url}\n  ${(item.highlights ?? []).slice(0, 3).join("\n  ") || item.summary || ""}`)
-			: ["- none"]),
-	];
-	return `${lines.join("\n")}\n`;
-}
-
-function renderOutputContent(value) {
-	if (value == null) return "_No synthesized output returned._";
-	if (typeof value === "string") return value;
-	return `\`\`\`json\n${JSON.stringify(value, null, 2)}\n\`\`\``;
-}
-
-async function ensureSourcesDir(ctx) {
-	const dir = join(ctx.repo, "agent", "page-writer", ctx.runId, ctx.actionId, "sources");
-	await mkdir(dir, { recursive: true });
-	return dir;
-}
-
-async function readJson(path) {
-	return JSON.parse(await readFile(path, "utf8"));
-}
-
-async function writeJson(path, value) {
-	await writeFile(path, `${JSON.stringify(value, null, 2)}\n`);
-}
-
-async function backendJson(method, path) {
-	const res = await backendRequest(method, path);
-	const text = await res.text();
-	if (!res.ok) throw new Error(`${method} ${path} failed (${res.status}): ${text.slice(0, 1000) || res.statusText}`);
-	return text ? JSON.parse(text) : {};
-}
-
-async function backendRequest(method, path) {
-	const baseUrl = getApiUrl();
-	const headers = { "Content-Type": "application/json" };
-	const internal = process.env.ANYMORPH_INTERNAL_API_KEY || process.env.AGENT_INTERNAL_API_KEY || process.env.CRON_SECRET;
-	if (internal) headers.Authorization = `Bearer ${internal}`;
-	else if (process.env.ANYMORPH_ACCESS_TOKEN) headers.Authorization = `Bearer ${process.env.ANYMORPH_ACCESS_TOKEN}`;
-	else {
-		const creds = readCredentials();
-		if (creds?.access_token) headers.Authorization = `Bearer ${creds.access_token}`;
-	}
-	if (!headers.Authorization) throw new Error("No backend credential found. Run `anymorph login` or set ANYMORPH_ACCESS_TOKEN/ANYMORPH_INTERNAL_API_KEY.");
-	return fetch(`${baseUrl}${path}`, { method, headers });
-}
-
-async function resolveWorkspaceId(workspace) {
-	if (/^(ws_|workspace_|[a-z0-9]{20,})/i.test(workspace)) return workspace;
-	try {
-		const payload = await backendJson("GET", "/api/cli/status");
-		const match = (payload.workspaces ?? []).find((item) => item.id === workspace || item.domain === workspace || item.domain === String(workspace).replace(/^www\./, ""));
-		return match?.id ?? workspace;
-	} catch {
-		return workspace;
-	}
-}
-
-function readCredentials() {
-	if (!existsSync(CRED_FILE)) return null;
-	try {
-		return JSON.parse(readFileSync(CRED_FILE, "utf8"));
-	} catch {
-		return null;
-	}
-}
-
-function getApiUrl() {
-	const creds = readCredentials();
-	return creds?.api_url ?? process.env.ANYMORPH_API_URL ?? "https://api.anymorph.ai";
-}
-
-function required(value, name) {
-	if (!value) throw new Error(`${name} is required`);
-	return value;
-}

package/dist/skillpacks/geo/skills/geo-pages-diagnosis/SKILL.md

@@ -1,51 +0,0 @@
----
-name: geo-pages-diagnosis
-description: Use when diagnosing Anymorph-generated GEO pages, generated-page iteration opportunities, regeneration candidates, or GEO page creation gaps.
----
-
-# GEO Pages Diagnosis
-
-Use this skill for Anymorph-generated or Anymorph-managed GEO page surfaces.
-
-The output is a compact diagnosis plus action candidates for `assetType="geo_page"`.
-
-## Scope
-
-Diagnose:
-
-- Existing generated page performance.
-- Missing generated pages for weak or uncovered intents.
-- GEO page refresh, regeneration, and technical fix candidates.
-- Commerce product fit for product-linked page creation.
-
-Do not propose:
-
-- Customer-owned page fixes as `geo_page`.
-- Third-party outreach or external profile work.
-- Product-linked create actions without product evidence.
-
-## Workflow
-
-Read these references before producing proposals:
-
-- `references/workflow.md` for the full generated-page product workflow, candidate rules, commerce product-fit rules, root causes, action families, and no-action cases.
-- `references/diagnosis-contract.md` for the exact runtime diagnosis contract and artifact submission shape.
-
-1. Read shared run context and the GEO page candidate slice.
-2. Use `list_geo_page_candidates` before broad SQL.
-3. Use `get_geo_intent_diagnostic` for weak intents and generated-page gaps.
-4. Use page visibility, page insights, content, source, and products only when needed.
-5. For commerce create actions, use product evidence before proposing product-linked pages.
-6. Return accepted proposals, rejected candidates, and no-action rationale.
-
-## Output Contract
-
-Each proposal should include:
-
-- intent id or proposed intent.
-- existing page id or URL for update actions.
-- suggested slug only as a non-binding hint for create actions.
-- target product ids when product-linked evidence is present.
-- root cause, action family, priority, confidence, and evidence.
-
-Never invent a final route or URL for create actions.

package/dist/skillpacks/geo/skills/geo-pages-diagnosis/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "GEO Pages Diagnosis"
-  short_description: "Diagnose generated GEO pages and GEO page creation gaps."
-  default_prompt: "Use $geo-pages-diagnosis to diagnose generated-page GEO opportunities for this workspace."

package/dist/skillpacks/geo/skills/geo-pages-diagnosis/references/diagnosis-contract.md

@@ -1,125 +0,0 @@
-# GEO Strategy: GEO Pages Diagnosis
-
-You diagnose Anymorph-generated CMS-backed GEO pages and intent gaps where a new GEO page may be needed.
-
-## Scope
-
-Work on:
-
-- generated CMS GEO pages
-- weak intents with no suitable owned or generated page
-- generated pages that need iteration, re-research, regeneration, or retirement
-
-Do not choose final production routes. The page generation executor owns route creation.
-
-## Cases
-
-- generated page exists but visibility is low
-- generated page is cited but brand is not mentioned
-- brand is mentioned but not recommended
-- low visibility and no page exists
-
-## Freshness And Indexing Guard
-
-Do not treat a newly generated page as weak just because it has no traffic,
-GSC impressions, or AI citations yet. If a generated page was published less
-than 7 days ago, return `no_action` / monitor unless there is a concrete
-non-performance defect such as wrong intent, crawl/indexation blocker,
-duplicate/cannibalization, missing brand/entity clarity, or factual/product
-claim error.
-
-If a generated page is not indexed after 7 days, flag this in the diagnosis.
-Use `technical_issue` when indexation, crawlability, canonical, sitemap,
-robots, noindex, render, or status-code evidence identifies a blocker. Use
-`insufficient_evidence` when indexation state is unknown but the page still has
-no measurable crawl, GSC, or visibility signal. Do not turn this into a content
-update by default.
-
-## Evidence Order
-
-Use the cheapest sufficient evidence.
-
-1. Common run context and routed candidates.
-2. `list_geo_page_candidates` for the first generated-page or no-page candidate slice.
-3. `get_geo_intent_diagnostic` for one intent before deeper checks.
-4. For commerce workspaces and hub/spoke create candidates, `get_intent_products` to verify catalog fit and product ids.
-5. `get_page_insights` default compact mode for page decision evidence; use `mode: "full"`, `get_page_visibility`, or `list_ai_responses` only when raw prompt/answer evidence changes the recommendation.
-6. Page age and indexation evidence before diagnosing low performance on existing generated pages.
-7. `get_page_content` for generated page body or technical diagnosis.
-8. `web_scrape` only for a specific cited/recommended competitor URL.
-9. `serp_snapshot` or `dataforseo_research` only when the evidence depends on external search demand or SERP shape.
-
-## Root Cause Buckets
-
-Allowed buckets:
-
-- `intent_coverage_gap`
-- `content_depth_gap`
-- `entity_clarity_gap`
-- `generic_content_gap`
-- `proof_gap`
-- `comparison_gap`
-- `positioning_gap`
-- `technical_issue`
-- `authority_gap`
-- `product_fit_gap`
-- `prompt_mismatch`
-- `already_healthy`
-- `insufficient_evidence`
-
-Use `authority_gap` only when external citation evidence or recommendation reasons support it.
-
-## Action Families
-
-Allowed families:
-
-- `create_hub_page`
-- `create_spoke_page`
-- `update_existing_page`
-- `replace_existing_page`
-- `remove_or_merge_page`
-- `no_action`
-
-## Output
-
-Produce one `geo_pages` diagnosis object in this shape.
-
-Do not write intermediate diagnosis JSON files directly.
-
-Do not include `workspaceId`, `runId`, `channel`, final action id, final URL, or final `assetType`; the orchestrator and executor derive them.
-
-For commerce workspaces, `create_hub_page` and `create_spoke_page` proposals must include product evidence from `get_intent_products` when catalog fit is fit or weak-fit. Put the selected product ids in `target.targetProductIds`. If catalog fit is no-fit, reject the create action or propose a non-product informational direction.
-
-For create proposals, put `target.pageRole: "HUB"` on `create_hub_page` and `target.pageRole: "SPOKE"` on `create_spoke_page`.
-
-Use this shape:
-
-```json
-{
-  "summary": "Short diagnosis.",
-  "proposals": [
-    {
-      "intentId": "intent_123",
-      "candidateType": "low_visibility_no_page",
-      "target": { "suggestedSlug": "optional-non-binding-hint", "pageRole": "HUB", "targetProductIds": ["optional-commerce-product-id"] },
-      "rootCauses": [
-        { "bucket": "intent_coverage_gap", "confidence": 0.81, "evidence": ["No page covers the weak intent."] }
-      ],
-      "actionFamily": "create_hub_page",
-      "operations": ["Generate a CMS-backed GEO page for the intent"],
-      "priority": "high",
-      "confidence": "high",
-      "evidence": [
-        { "type": "workspace", "ref": "geo_page_intent_visibility_gaps:intent_123", "summary": "Low visibility with no owned or generated page." }
-      ],
-      "whyNow": "Why this matters this week.",
-      "risks": []
-    }
-  ],
-  "rejected": [
-    { "ref": "page_456", "reason": "Existing page is healthy." },
-    { "ref": "page_789", "reason": "Generated page was published less than 7 days ago; monitor until the minimum observation window has passed." },
-    { "ref": "page_999", "reason": "Generated page is not indexed after 7 days; flag indexation analysis before recommending content changes." }
-  ]
-}
-```