anymorph 0.2.1 → 0.2.3

package/README.md

@@ -142,6 +142,11 @@ anymorph geo init --repo .
 anymorph geo init --repo . --skills-source /path/to/anymorph-geo-skills/plugins/anymorph-geo/skills
 ```
 
+By default, `init` uses the GEO skillpack bundled inside the installed
+`anymorph` npm package. That means tenant users do not need access to the
+private `anymorph-geo-skills` repo. `--skills-source` is only for internal local
+development when testing an unreleased skillpack.
+
 This installs managed skills under `.claude/skills` and `.agents/skills`, writes
 `agent/contracts`, creates `agent/runs` and `agent/archive`, and creates missing
 memory files without overwriting existing `agent/BRAND.md`, `agent/STRATEGY.md`,

package/dist/index.js

@@ -7430,6 +7430,7 @@ var DEFAULT_SKILLPACK_RELATIVE_PATH = join4(
   "skills"
 );
 var MANAGED_PATHS = [".claude/skills", ".agents/skills", "agent/contracts"];
+var BUNDLED_SKILLPACK_RELATIVE_PATH = join4("skillpacks", "geo", "skills");
 async function initGeoScaffold(input) {
   return applyGeoScaffold(input, { createMemory: true });
 }
@@ -7476,14 +7477,22 @@ async function resolveSkillSourceDir(explicit) {
     await ensureDirectory2(resolved);
     return resolved;
   }
+  const bundled = await resolveBundledSkillSourceDir();
+  if (bundled) return bundled;
   for (const root of searchRoots()) {
     const candidate = join4(root, DEFAULT_SKILLPACK_RELATIVE_PATH);
     if (await isDirectory(candidate)) return candidate;
   }
   throw new Error(
-    `Could not find GEO skillpack. Pass --skills-source <path> pointing to ${DEFAULT_SKILLPACK_RELATIVE_PATH}.`
+    `Could not find bundled GEO skillpack. Reinstall or update the anymorph CLI, or pass --skills-source <path> pointing to ${DEFAULT_SKILLPACK_RELATIVE_PATH}.`
   );
 }
+async function resolveBundledSkillSourceDir(fromUrl = new URL(import.meta.url)) {
+  const moduleDir = dirname(fileURLToPath2(fromUrl));
+  const candidate = join4(moduleDir, BUNDLED_SKILLPACK_RELATIVE_PATH);
+  if (await isDirectory(candidate)) return candidate;
+  return null;
+}
 async function applyGeoScaffold(input, options) {
   const repoPath = resolve2(input.repoPath);
   const skillsSourceDir = await resolveSkillSourceDir(input.skillsSourceDir);
@@ -7562,12 +7571,14 @@ async function ensureMemoryFiles(repoPath, changed) {
 }
 async function writeSkillpackLock(input, changed) {
   const sourceCommit = await gitOutput2(input.skillsSourceDir, ["rev-parse", "HEAD"]);
+  const cliPackageVersion = await readCliPackageVersion();
   const lock = {
     name: "anymorph-geo",
     source: input.skillsSourceDir,
     sourceRepo: "opactor-dev/anymorph-geo-skills",
     requestedRef: input.ref,
     resolvedCommit: sourceCommit,
+    cliPackageVersion,
     manifestHash: input.manifestHash,
     installedAt: (/* @__PURE__ */ new Date()).toISOString(),
     managedPaths: MANAGED_PATHS
@@ -7653,6 +7664,15 @@ async function gitOutput2(cwd, args) {
     return null;
   }
 }
+async function readCliPackageVersion() {
+  for (const root of searchRoots()) {
+    const packageJson = await readJson(join4(root, "package.json"));
+    if (packageJson && typeof packageJson === "object" && packageJson.name === "anymorph" && typeof packageJson.version === "string") {
+      return packageJson.version;
+    }
+  }
+  return null;
+}
 function searchRoots() {
   const roots = /* @__PURE__ */ new Set();
   let cwd = resolve2(process.cwd());
@@ -7898,10 +7918,10 @@ function shortPath(path2) {
 // src/commands/geo.ts
 function buildGeoCommand() {
   const geo = new Command("geo").description("Manage local GEO repo setup and strategy runs");
-  geo.command("init").description("Initialize GEO scaffold and skills in a tenant repo").option("--repo <path>", "Tenant repo path", ".").option("--skills-source <path>", "Use an explicit GEO skillpack source directory").option("--ref <ref>", "Skillpack ref label to write into agent/skillpack.json", "local").option("--json", "Output as JSON").action(geoInitCommand);
-  geo.command("sync").description("Sync managed GEO scaffold files without touching memory or run artifacts").option("--repo <path>", "Tenant repo path", ".").option("--skills-source <path>", "Use an explicit GEO skillpack source directory").option("--ref <ref>", "Skillpack ref label to write into agent/skillpack.json", "local").option("--json", "Output as JSON").action(geoSyncCommand);
-  geo.command("doctor").description("Check whether a tenant repo GEO scaffold matches the installed skillpack").option("--repo <path>", "Tenant repo path", ".").option("--skills-source <path>", "Use an explicit GEO skillpack source directory").option("--json", "Output as JSON").action(geoDoctorCommand);
-  geo.command("prepare <workspace>").description("Prepare a local GEO strategy run package").option("--repo <path>", "Use an explicit tenant repo path").option("--days <days>", "Signal lookback window in days", parsePositiveInt).option("--skills-source <path>", "Use an explicit GEO skillpack source directory").option("--skip-scaffold", "Skip GEO scaffold sync before writing the run package").option("--json", "Output as JSON").action(geoPrepareCommand);
+  geo.command("init").description("Initialize GEO scaffold and skills in a tenant repo").option("--repo <path>", "Tenant repo path", ".").option("--skills-source <path>", "Use an explicit GEO skillpack source directory instead of the bundled skillpack").option("--ref <ref>", "Skillpack ref label to write into agent/skillpack.json", "bundled").option("--json", "Output as JSON").action(geoInitCommand);
+  geo.command("sync").description("Sync managed GEO scaffold files without touching memory or run artifacts").option("--repo <path>", "Tenant repo path", ".").option("--skills-source <path>", "Use an explicit GEO skillpack source directory instead of the bundled skillpack").option("--ref <ref>", "Skillpack ref label to write into agent/skillpack.json", "bundled").option("--json", "Output as JSON").action(geoSyncCommand);
+  geo.command("doctor").description("Check whether a tenant repo GEO scaffold matches the installed skillpack").option("--repo <path>", "Tenant repo path", ".").option("--skills-source <path>", "Use an explicit GEO skillpack source directory instead of the bundled skillpack").option("--json", "Output as JSON").action(geoDoctorCommand);
+  geo.command("prepare <workspace>").description("Prepare a local GEO strategy run package").option("--repo <path>", "Use an explicit tenant repo path").option("--days <days>", "Signal lookback window in days", parsePositiveInt).option("--skills-source <path>", "Use an explicit GEO skillpack source directory instead of the bundled skillpack").option("--skip-scaffold", "Skip GEO scaffold sync before writing the run package").option("--json", "Output as JSON").action(geoPrepareCommand);
   geo.command("validate <runId>").description("Validate local GEO strategy run artifacts before pushing").option("--repo <path>", "Use an explicit tenant repo path").option("--json", "Output as JSON").action(geoValidateCommand);
   geo.command("intents <runId>").description("Show the pre-fetched intents for a local GEO strategy run").option("--repo <path>", "Use an explicit tenant repo path").option("--json", "Output as JSON").action(geoIntentsCommand);
   geo.command("status <runId>").description("Show backend sync status for a GEO strategy run").option("--json", "Output as JSON").action(geoStatusCommand);
@@ -8158,7 +8178,7 @@ function printScaffoldError(prefix, err) {
 
 // src/index.ts
 var program2 = new Command();
-program2.name("anymorph").description("Check your brand's AI visibility \u2014 powered by Anymorph").version("0.2.0");
+program2.name("anymorph").description("Check your brand's AI visibility \u2014 powered by Anymorph").version("0.2.3");
 program2.command("login").description("Sign in to your Anymorph account").action(loginCommand);
 program2.command("check <domain>").description("Check AI visibility for a domain").option("--json", "Output as JSON").action(checkCommand);
 program2.command("status").description("Show current auth status").action(statusCommand);

package/dist/skillpacks/geo/skills/brand-owned-diagnosis/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: brand-owned-diagnosis
+description: Use when diagnosing customer-owned discovered pages for GEO strategy actions, owned-site visibility gaps, content coverage issues, or technical page fixes.
+---
+
+# Brand-Owned Diagnosis
+
+Use this skill for customer-owned pages that are not Anymorph-generated GEO pages.
+
+The output is a compact diagnosis plus action candidates for `assetType="brand_owned"`.
+
+## Scope
+
+Diagnose:
+
+- Existing brand-owned page coverage.
+- Content clarity, proof, comparison, and entity gaps.
+- Technical or crawl blockers on customer-owned pages.
+- GSC, SERP, AI response, and competitor gaps tied to a known owned URL.
+
+Do not propose:
+
+- Generated GEO page work.
+- Third-party outreach or external profile work.
+- New page generation when an existing generated GEO page is the right surface.
+
+## Workflow
+
+Read these references before producing proposals:
+
+- `references/workflow.md` for the full brand-owned product workflow, candidate rules, root causes, action families, scoring, 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 brand-owned candidate slice.
+2. Use `list_geo_strategy_candidates` before broad SQL.
+3. Use `get_geo_intent_diagnostic` for intent-level explanation.
+4. Read page content or source only when the recommendation depends on the body or technical implementation.
+5. Return accepted proposals, rejected candidates, and no-action rationale.
+
+## Output Contract
+
+Return proposals that can be merged into final GEO actions.
+
+Each proposal should include:
+
+- intent or proposed intent.
+- existing page URL or page id when known.
+- root cause.
+- operation family.
+- priority and confidence.
+- evidence references.
+- concise change brief.
+
+Use no action when the owned page is not the bottleneck.

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

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Brand-Owned Diagnosis"
+  short_description: "Diagnose customer-owned pages for GEO strategy actions."
+  default_prompt: "Use $brand-owned-diagnosis to diagnose owned-page GEO gaps for this workspace."

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

@@ -0,0 +1,96 @@
+# GEO Strategy: Brand-Owned Diagnosis
+
+You diagnose customer-owned discovered pages.
+
+## Scope
+
+Work only on pages where the tenant/customer site owns the page and the page is not an Anymorph-generated GEO page.
+
+Cases:
+
+- page exists but visibility is low
+- page is cited but the brand is not mentioned
+- brand is mentioned but not recommended
+
+Do not propose GEO page generation unless the orchestrator explicitly asks you to compare update-vs-create.
+
+## Evidence Order
+
+Use the cheapest sufficient evidence.
+
+1. Common run context and candidate rows from the orchestrator.
+2. `list_geo_strategy_candidates` for the first brand-owned candidate slice.
+3. `get_geo_intent_diagnostic` for one intent before deeper checks.
+4. `get_page_insights`, `get_page_visibility`, or `list_ai_responses` for page/prompt evidence.
+5. `get_page_content` or `get_page_source_code` only when content or technical diagnosis depends on the page body.
+6. `web_scrape` only for a specific competitor URL that changes the recommendation.
+
+Do not scrape broadly.
+
+## Root Cause Buckets
+
+Allowed buckets:
+
+- `intent_coverage_gap`
+- `content_depth_gap`
+- `entity_clarity_gap`
+- `generic_content_gap`
+- `proof_gap`
+- `comparison_gap`
+- `technical_issue`
+- `authority_gap`
+- `prompt_mismatch`
+- `not_a_problem`
+- `insufficient_evidence`
+
+Use `authority_gap` only with external citation evidence or repeated competitor recommendation reasons.
+
+## Action Families
+
+Allowed families:
+
+- `refresh_existing_page`
+- `retarget_existing_page`
+- `improve_entity_clarity`
+- `add_proof`
+- `add_comparison_coverage`
+- `fix_technical_issue`
+- `no_action`
+
+## Output
+
+Produce one `brand_owned` diagnosis object in this shape.
+
+Do not write intermediate diagnosis JSON files directly.
+
+Do not include `workspaceId`, `runId`, `channel`, final action id, or final `assetType`; the orchestrator can derive them.
+
+Use this shape:
+
+```json
+{
+  "summary": "Short diagnosis.",
+  "proposals": [
+    {
+      "intentId": "intent_123",
+      "candidateType": "page_exists_low_visibility",
+      "target": { "pageId": "page_123", "url": "https://example.com/page" },
+      "rootCauses": [
+        { "bucket": "proof_gap", "confidence": 0.72, "evidence": ["Specific evidence summary"] }
+      ],
+      "actionFamily": "add_proof",
+      "operations": ["Add customer proof near the answer block"],
+      "priority": "high",
+      "confidence": "medium",
+      "evidence": [
+        { "type": "signal", "ref": "geo_recommendation_quadrants:intent_123", "summary": "Mentioned but not recommended dominates." }
+      ],
+      "whyNow": "Why this matters this week.",
+      "risks": ["Uncertainty or dependency"]
+    }
+  ],
+  "rejected": [
+    { "ref": "intent_456", "reason": "Suppressed by recent action mask." }
+  ]
+}
+```

package/dist/skillpacks/geo/skills/brand-owned-diagnosis/references/workflow.md

@@ -0,0 +1,191 @@
+# Brand-Owned Diagnosis Workflow
+
+## Role
+
+The `brand_owned` channel diagnosis diagnoses and proposes actions for customer-owned discovered pages.
+
+It works on pages where:
+
+- `source = discovered`
+- the page belongs to the tenant/customer site
+- the action would improve an existing natural page or recommend a customer-site content action
+
+## Non-Goals
+
+- Do not iterate generated GEO pages.
+- Do not decide final routes for generated pages.
+- Do not propose third-party outreach.
+- Do not perform deep URL tree planning in MVP.
+- Do not require `PageContentLabel`.
+
+## Inputs
+
+- candidate rows routed by the orchestrator
+- tenant `agent/BRAND.md`
+- tenant `agent/STRATEGY.md`
+- tenant `agent/LEARNINGS.md`
+- relevant rows from:
+  - `geo_pages`
+  - `geo_intent_coverage`
+  - `geo_recommendation_quadrants`
+  - `geo_page_intent_visibility_gaps`
+  - `geo_page_performance`
+  - `geo_strategy_actions_recent`
+- page scrape when needed
+- AI answer samples when needed
+- competitor page scrape when needed
+
+## Workflow
+
+### 1. Filter Candidates
+
+Keep candidates where:
+
+- page source is `discovered`
+- page has an intent
+- intent is weak, or quadrant state indicates a fixable issue
+
+Drop candidates when:
+
+- page is not indexable and the tenant strategy forbids technical page edits
+- recent action mask suppresses the same action
+- evidence is too thin to justify an action
+
+### 2. Classify Candidate Case
+
+Assign one primary case.
+
+#### A. Page Exists But Visibility Is Low
+
+Use when:
+
+- discovered page exists
+- `current_visibility` is low
+- quadrant is mostly `absent`, `cited_unnamed`, or `mentioned_not_recommended`
+
+Diagnosis questions:
+
+1. Does the page directly answer the intent?
+2. Is coverage deep enough for representative prompts?
+3. Is the writing weaker than the most-cited or most-recommended competitor page?
+4. Is there a visible technical issue?
+5. Is authority the likely bottleneck, or only a weak hypothesis?
+
+#### B. Cited But Not Mentioned
+
+Use when:
+
+- our page/source is cited
+- brand is not clearly mentioned
+
+Diagnosis questions:
+
+1. Is the page clearly tied to the tenant brand?
+2. Do title, H1, intro, byline, publisher, schema, and about/proof signals make the entity clear?
+3. Is the content too generic to make the brand worth mentioning?
+
+#### C. Mentioned But Not Recommended
+
+Use when:
+
+- tenant brand is mentioned
+- competitors are recommended more often
+
+Diagnosis questions:
+
+1. Which brands were recommended?
+2. What reasons did the AI answer give or imply?
+3. What content-level weakness exists on the tenant page?
+
+### 3. Gather Evidence
+
+Use the cheapest sufficient evidence.
+
+Default evidence:
+
+- view rows
+- page title/H1/path/status
+- quadrant rates
+- page performance summary
+- AI answer excerpt
+
+Fetch page scrape when:
+
+- diagnosis depends on content coverage, proof, comparison, or entity clarity
+
+Fetch competitor page scrape when:
+
+- the answer repeatedly recommends or cites a competitor page
+- the proposed action depends on competitor comparison
+
+Do not scrape everything.
+
+### 4. Pick Root Cause Buckets
+
+Allowed buckets:
+
+- `intent_coverage_gap`
+- `content_depth_gap`
+- `entity_clarity_gap`
+- `generic_content_gap`
+- `proof_gap`
+- `comparison_gap`
+- `technical_issue`
+- `authority_gap`
+- `prompt_mismatch`
+- `not_a_problem`
+- `insufficient_evidence`
+
+Use `authority_gap` only when supported by external citation evidence or repeated competitor recommendation reasons.
+
+### 5. Route Action
+
+Allowed action families:
+
+- `refresh_existing_page`
+- `retarget_existing_page`
+- `improve_entity_clarity`
+- `add_proof`
+- `add_comparison_coverage`
+- `fix_technical_issue`
+- `no_action`
+
+Prefer update actions over create actions when an existing discovered page clearly owns the intent.
+
+### 6. Output
+
+Return a compact diagnosis for each accepted action:
+
+- candidate type
+- page URL/pageId
+- intentId
+- root cause buckets with confidence
+- recommended action family
+- concrete operations
+- evidence references
+- why other actions were rejected
+
+## Examples
+
+### Covered But Weak
+
+If a discovered page exists, visibility is low, and the page only gives generic education while competitor pages provide comparison criteria and proof:
+
+- root cause: `comparison_gap`, `proof_gap`
+- action family: `add_comparison_coverage`
+- operation: add comparison criteria and customer proof to the existing page
+
+### Cited But Not Mentioned
+
+If the page is cited but the AI answer does not name the tenant brand:
+
+- root cause: `entity_clarity_gap`
+- action family: `improve_entity_clarity`
+- operation: strengthen brand naming, publisher schema, and product/company relationship in the answer block
+
+## Guardrails
+
+- Do not propose creating a generated GEO page from this channel diagnosis unless the orchestrator explicitly routes no-page candidates here.
+- Do not over-index on page type labels.
+- Do not call content "thin" without page scrape or word-count/section evidence.
+- Do not diagnose authority from low visibility alone.

package/dist/skillpacks/geo/skills/geo-generating-actions/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: geo-generating-actions
+description: Use when generating recurring or on-demand GEO strategy actions from tenant memory, run context, channel diagnoses, and evidence-backed opportunity candidates.
+---
+
+# GEO Generating Actions
+
+Use this skill to orchestrate GEO action generation.
+
+This skill owns the final decision. Channel diagnosis should be handled by product diagnosis skills, then merged and judged here.
+
+## Channel Skills
+
+Use these skills for channel-specific diagnosis:
+
+- `$brand-owned-diagnosis` for customer-owned pages.
+- `$geo-pages-diagnosis` for generated GEO pages.
+- `$third-party-diagnosis` for Earn and external authority work.
+
+## Required Reference
+
+Read `references/orchestrator.workflow.md` before final action selection. It contains the full production workflow: context construction, channel invocation order, proposal merge rules, conflict resolution, no-action discipline, and final artifact contract.
+
+## Workflow
+
+1. Read host-created run files and stable tenant memory.
+2. Build one compact shared run context.
+3. Invoke or apply the three channel diagnosis skills.
+4. Read channel outputs and reject weak, duplicate, or conflicting proposals.
+5. Prefer no action over low-evidence action.
+6. Submit final actions through runtime artifact tools; do not write `actions.json` directly.
+7. Write rationale and status files only under the current run path.
+8. Update durable tenant memory only when the run changes stable strategy or repeated learnings.
+
+## Final Decision Rules
+
+- Emit at most 20 actions.
+- Use only `create` or `update` operations.
+- Use `brand_owned` only for customer-owned discovered pages.
+- Use `geo_page` only for generated or managed GEO page work.
+- Use `third_party` only for off-page Earn work.
+- Every action must include either an existing `intentId` or a non-null `proposedIntent`.
+- Third-party actions must name the exact domain and, when known, the exact publish surface.

package/dist/skillpacks/geo/skills/geo-generating-actions/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "GEO Generating Actions"
+  short_description: "Generate final GEO strategy actions from channel diagnoses."
+  default_prompt: "Use $geo-generating-actions to generate final GEO strategy actions for this workspace."