agentlinkops 0.6.13 → 0.6.16

package/skills/agentlinkops-crm/SKILL-DEPS.json

@@ -0,0 +1,381 @@
+{
+  "schemaVersion": 1,
+  "skill": "agentlinkops-crm",
+  "pack": "product",
+  "contractSha256": "e3d29a169dd1ecae2db26b22ab666419c4057e84831653df655f04ae61725e93",
+  "sourceManifest": [
+    {
+      "path": "references/cli.md",
+      "sha256": "7b665f9d9b60cdab1f0238b71500f8389e0a6df4ea9777db69af6627a000a766"
+    },
+    {
+      "path": "references/disavow.md",
+      "sha256": "f8a2ad2c779e15547c6cf6a199b1d4af18ad2ef2c0aa8f27094c00f366c55aaa"
+    },
+    {
+      "path": "references/local-crm-draft-handoff.md",
+      "sha256": "4fb6f0bc9caf5e4ba79250ea41d4588f9d504b04c63d7e388d8e471b850924b7"
+    },
+    {
+      "path": "references/portable-ledger-handoff.md",
+      "sha256": "fa4c3c7efea90dd8007e5ba25e4dbb67bfafa8963d91000eb3d58da61b1d9db6"
+    },
+    {
+      "path": "references/reports.md",
+      "sha256": "361ea12f145daf15c30d35cfaec3f41bfa677fee9c5eabf7dc10b6004cbe617e"
+    },
+    {
+      "path": "scripts/agentlinkops.py",
+      "sha256": "91d541768f95e17c059396624c153ca86395bccfc565a8bf3470e2e006404e28"
+    },
+    {
+      "path": "scripts/disavow.py",
+      "sha256": "cae36ad7d9e4aef27510975b4c15a66e5649250f6e76df7ca2bfb025a696432e"
+    },
+    {
+      "path": "scripts/migrations/001_crm.sql",
+      "sha256": "049fbd38b05c5b8dbab00b6ebee5342b8ed5cf48f65fe6cc1bbf41330ceedf54"
+    },
+    {
+      "path": "scripts/migrations/002_cloud_events.sql",
+      "sha256": "9040c607408ffd9a168bb3c30431846ddbc7a3429b2a30ba3ecafd4048ccc0c3"
+    },
+    {
+      "path": "scripts/migrations/003_disavow.sql",
+      "sha256": "ff47da734afaff5ab364dc0ae53c3db58254d0a30ca5250de8172a67f8ec2772"
+    },
+    {
+      "path": "scripts/migrations/004_placement_costs.sql",
+      "sha256": "e25732a3abd95d54320984068d9a4242ee2d0b89f6c70330a24f63bd0a3671a2"
+    },
+    {
+      "path": "scripts/outreach-crm-draft.py",
+      "sha256": "f673603b4be3f20df44a9531191241ae2c2e44881b9d82f8fa42fba7c327da7a"
+    },
+    {
+      "path": "scripts/portable-handoff.py",
+      "sha256": "c4aa4036b41f840bf4eebfbff1e8a6b441f2706d09e027d7eb4f746f4f7eee0d"
+    },
+    {
+      "path": "scripts/report.py",
+      "sha256": "c7088c3314d0453d62e8a70f0c80f535b219b2ea127ca7d1c0731b216a9cb602"
+    },
+    {
+      "path": "skills/agentlinkops-crm/SKILL.md",
+      "sha256": "c1131f7abfb76229a9346e7c9ff9cf71e580a540e11bc2caeba969d31235802a"
+    },
+    {
+      "path": "skills/agentlinkops-crm/agents/openai.yaml",
+      "sha256": "692201114c28fa70250fae09230d15fb182b1e1b3ce84f737bec1773b3fd68b1"
+    },
+    {
+      "path": "templates/campaigns.v1.json",
+      "sha256": "768e1610d64b82a4e5872c301eb2a537705821b2f01e9f2265c8056f7da4a496"
+    }
+  ],
+  "members": [
+    {
+      "path": "SKILL.md",
+      "sha256": "1ac0d2c4a1a1c0b0f1f18302577656d6f3e8e22c7329ecba92b3951e78715867"
+    },
+    {
+      "path": "agents/openai.yaml",
+      "sha256": "692201114c28fa70250fae09230d15fb182b1e1b3ce84f737bec1773b3fd68b1"
+    },
+    {
+      "path": "references/portable/references/cli.md",
+      "sha256": "55ad759a920ed5bb683b0354739b7a929a0d733e987c6164977ea466ff606955"
+    },
+    {
+      "path": "references/portable/references/disavow.md",
+      "sha256": "47b4b335f7695209ad0758fc19f3b23b38792032a6850277e563a9b7d80eabf1"
+    },
+    {
+      "path": "references/portable/references/local-crm-draft-handoff.md",
+      "sha256": "b8e027add77f9bbd3c71990a8b3d8ec45e99ceae2b7f0d8eb33697cfcd0eae82"
+    },
+    {
+      "path": "references/portable/references/portable-ledger-handoff.md",
+      "sha256": "0942083b6d9c0c9604623536a7e7b9c44341c7cc5bfde74fa9abdffbf2fbcf62"
+    },
+    {
+      "path": "references/portable/references/reports.md",
+      "sha256": "4fc4791d03c7497f0193fb3d6b4114095aad4d551bb063c8c9e9c485f0c8ca56"
+    },
+    {
+      "path": "references/portable/scripts/agentlinkops.py",
+      "sha256": "91d541768f95e17c059396624c153ca86395bccfc565a8bf3470e2e006404e28"
+    },
+    {
+      "path": "references/portable/scripts/disavow.py",
+      "sha256": "cae36ad7d9e4aef27510975b4c15a66e5649250f6e76df7ca2bfb025a696432e"
+    },
+    {
+      "path": "references/portable/scripts/migrations/001_crm.sql",
+      "sha256": "049fbd38b05c5b8dbab00b6ebee5342b8ed5cf48f65fe6cc1bbf41330ceedf54"
+    },
+    {
+      "path": "references/portable/scripts/migrations/002_cloud_events.sql",
+      "sha256": "9040c607408ffd9a168bb3c30431846ddbc7a3429b2a30ba3ecafd4048ccc0c3"
+    },
+    {
+      "path": "references/portable/scripts/migrations/003_disavow.sql",
+      "sha256": "ff47da734afaff5ab364dc0ae53c3db58254d0a30ca5250de8172a67f8ec2772"
+    },
+    {
+      "path": "references/portable/scripts/migrations/004_placement_costs.sql",
+      "sha256": "e25732a3abd95d54320984068d9a4242ee2d0b89f6c70330a24f63bd0a3671a2"
+    },
+    {
+      "path": "references/portable/scripts/outreach-crm-draft.py",
+      "sha256": "f673603b4be3f20df44a9531191241ae2c2e44881b9d82f8fa42fba7c327da7a"
+    },
+    {
+      "path": "references/portable/scripts/portable-handoff.py",
+      "sha256": "c4aa4036b41f840bf4eebfbff1e8a6b441f2706d09e027d7eb4f746f4f7eee0d"
+    },
+    {
+      "path": "references/portable/scripts/report.py",
+      "sha256": "c7088c3314d0453d62e8a70f0c80f535b219b2ea127ca7d1c0731b216a9cb602"
+    },
+    {
+      "path": "references/portable/templates/campaigns.v1.json",
+      "sha256": "768e1610d64b82a4e5872c301eb2a537705821b2f01e9f2265c8056f7da4a496"
+    }
+  ],
+  "edges": [
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/references/disavow.md",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/references/reports.md",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/cli.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/disavow.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/disavow.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/disavow.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/disavow.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/disavow.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/local-crm-draft-handoff.md",
+      "target": "references/portable/scripts/outreach-crm-draft.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/local-crm-draft-handoff.md",
+      "target": "references/portable/scripts/outreach-crm-draft.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/portable-ledger-handoff.md",
+      "target": "references/portable/scripts/portable-handoff.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/reports.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/references/reports.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/scripts/agentlinkops.py",
+      "target": "references/portable/scripts/disavow.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/scripts/agentlinkops.py",
+      "target": "references/portable/scripts/migrations/001_crm.sql",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/scripts/agentlinkops.py",
+      "target": "references/portable/scripts/report.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/scripts/agentlinkops.py",
+      "target": "references/portable/templates/campaigns.v1.json",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/scripts/outreach-crm-draft.py",
+      "target": "references/portable/scripts/portable-handoff.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "references/portable/scripts/outreach-crm-draft.py",
+      "target": "references/portable/scripts/portable-handoff.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "../../references/recipes/placement-reconciliation.md",
+      "kind": "optional-selected",
+      "selection": "agentlinkops agent setup --recipe placement-reconciliation"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/references/cli.md",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/references/cli.md",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/references/disavow.md",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/references/local-crm-draft-handoff.md",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/references/portable-ledger-handoff.md",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/references/reports.md",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/scripts/agentlinkops.py",
+      "kind": "required-bundled"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/scripts/outreach-crm-draft.py",
+      "kind": "required-bundled"
+    }
+  ],
+  "externalRuntime": [
+    {
+      "kind": "external-runtime",
+      "id": "agentlinkops-cli",
+      "commands": [
+        "agentlinkops",
+        "linktrail",
+        "node cli/agentlinkops.mjs"
+      ],
+      "availability": "Install separately for a standalone skill; inspect the installed version and help before using a local command. Hosted discovery does not install local CLI features."
+    },
+    {
+      "kind": "external-runtime",
+      "id": "python-standard-library",
+      "minimumVersion": "3.10",
+      "imports": [
+        "argparse",
+        "contextlib",
+        "csv",
+        "datetime",
+        "decimal",
+        "errno",
+        "fcntl",
+        "hashlib",
+        "html",
+        "importlib",
+        "io",
+        "ipaddress",
+        "json",
+        "os",
+        "pathlib",
+        "re",
+        "sqlite3",
+        "stat",
+        "sys",
+        "tempfile",
+        "time",
+        "urllib"
+      ]
+    },
+    {
+      "kind": "external-runtime",
+      "id": "agentlinkops-hosted-mcp",
+      "availability": "Hosted commands require separately connected customer access and current catalog exposure. Installing a skill alone does not establish access."
+    }
+  ],
+  "privateExcluded": [
+    "private Fleet/account files",
+    "customer records and credentials",
+    "unselected or uncleared publisher material"
+  ],
+  "coverage": "Assembler records source hashes; independent archive verification recomputes required members, supported links/imports and declared resources. Optional selections and external runtimes remain separate."
+}

package/skills/agentlinkops-crm/SKILL.md

@@ -1,26 +1,30 @@
 ---
 name: agentlinkops-crm
 description: Manage the AgentLinkOps local backlink and outreach CRM, user-selected disavow lists, branded HTML reports and cloud event sync. Use for durable campaign records, link reporting or explicit disavow-list management; does not connect a mailbox, send outreach or upload disavow files.
-allowed-tools: Read Bash(python3 ../../scripts/agentlinkops.py *) Bash(python3 ../../scripts/outreach-crm-draft.py *) Bash(node cli/agentlinkops.mjs *) Bash(agentlinkops *)
+allowed-tools: Read Bash(python3 references/portable/scripts/agentlinkops.py *) Bash(python3 references/portable/scripts/outreach-crm-draft.py *) Bash(agentlinkops *)
 ---
 
-**For the optional bundled CLI, the local surface is the ledger file.** `.agentlinkops/links.jsonl` in the user's repository (or a `.linktrail/` directory from an earlier install, read until `agentlinkops migrate` renames it) declares the links they expect, want and have earned, and `agentlinkops check` runs the exact cloud verifier against it without an account. Run the CLI as `node cli/agentlinkops.mjs` from the repository or plugin-package root (`cli/linktrail.mjs` still works and prints a one-line notice); the packaged plugin ships the CLI, its pinned verifier modules and their pinned runtime dependencies inside the package, so the installed package needs no npm install; checking a publisher still requires a read-only network fetch. It needs Node 22 or newer (`adopt` reads SQLite databases through `node:sqlite`); the Python helper below needs Python 3.10+. This CRM is one optional adapter beside CSV and JSONL: it is available, tested and unchanged, and nothing requires it. When a user already keeps links here, `agentlinkops adopt <db>` reads it into ledger entries — read-only, adding no schema — and previews unless `--write` is given. Do not propose the CRM as the place a user should start keeping links; propose it when they want contacts and outreach activity beside them, or when they already have one.
+**The CLI's local surface is the ledger file.** `.agentlinkops/links.jsonl` in the user's repository (or a `.linktrail/` directory from an earlier install, read until `agentlinkops migrate` renames it) declares the links they expect, want and have earned. `agentlinkops check` uses the shared verifier without an account; checking a publisher still requires a read-only network fetch.
+
+The full plugin includes the CLI and its runtime dependencies. A standalone skill includes the Python helper and required references, but needs a separately installed CLI for ledger commands. Check `agentlinkops --version` and help before using local features; hosted command refresh does not install them. The CLI needs Node 22 or newer; the Python helper needs Python 3.10 or newer.
+
+This CRM is an optional adapter beside CSV and JSONL. When a user already keeps links here, `agentlinkops adopt <db>` reads the database without changing its schema and previews ledger entries unless `--write` is given. Offer this CRM when the user wants contacts and outreach activity beside their links, or already has records in it.
 
 To record a link in the ledger: `agentlinkops add --source URL --target URL --intent expected [--anchor TEXT] [--ref ID] [--note TEXT]` (`--intent wanted` for a link not yet earned; `agentlinkops init` first in a repository without `.agentlinkops/`). `agentlinkops check` then verifies every expected link and returns 0 when no expected placement is conclusively absent, 1 when one is observed absent with complete evidence, 2 on a usage or ledger error. Unknown is nonfailing by default; `--fail-on-unknown` returns 1 for an unknown result in text or JSON output.
 
-Use the deterministic Python helper at `../../scripts/agentlinkops.py`, resolved relative to this skill's directory. It requires Python 3.10+ and only its standard library. Run `--help` for the command surface. Keep the database outside the plugin installation directory; updates can replace that directory.
+Use the deterministic Python helper at `references/portable/scripts/agentlinkops.py`, resolved relative to this skill's directory. It requires Python 3.10+ and only its standard library. Run `--help` for the command surface. Keep the database outside the plugin installation directory; updates can replace that directory.
 
-Read [the CLI contract](../../references/cli.md) for fields and examples. The CRM contains products, campaigns, contacts, opportunities, activities and placements. Use explicit stable IDs and upsert a record to update it. Bulk records of one entity are committed together. Save source URLs and observed dates alongside contact and qualification evidence.
+Read [the CLI contract](references/portable/references/cli.md) for fields and examples. The CRM contains products, campaigns, contacts, opportunities, activities and placements. Use explicit stable IDs and upsert a record to update it. Bulk records of one entity are committed together. Save source URLs and observed dates alongside contact and qualification evidence.
 
-When the user asks to manage a disavow list, read [the disavow contract](../../references/disavow.md). Scope every operation to the exact user-selected URL-prefix property. Preserve provenance and the user's explicit rule choices. Do not decide to disavow a site from a low score, inaccessible page or generic risk label. The helper imports and exports local files; it has no Google upload capability. Reimporting a prior file does not reactivate rules the user disabled.
+When the user asks to manage a disavow list, read [the disavow contract](references/portable/references/disavow.md). Scope every operation to the exact user-selected URL-prefix property. Preserve provenance and the user's explicit rule choices. Do not decide to disavow a site from a low score, inaccessible page or generic risk label. The helper imports and exports local files; it has no Google upload capability. Reimporting a prior file does not reactivate rules the user disabled.
 
-For a shareable placement report, read [the report contract](../../references/reports.md). Select the requested project and brand/title. Reports include observed placement data by default. Include local notes or cost amounts only when the user requests that content; those fields may contain private commercial context. The output is self-contained HTML, not a generated PDF. A report timestamp does not make its underlying observations fresh.
+For a shareable placement report, read [the report contract](references/portable/references/reports.md). Select the requested project and brand/title. Reports include observed placement data by default. Include local notes or cost amounts only when the user requests that content; those fields may contain private commercial context. The output is self-contained HTML, not a generated PDF. A report timestamp does not make its underlying observations fresh.
 
 Preserve an existing CRM's workspace binding. Never initialize over an unrelated database, rewrite migration checksums, delete data to resolve a migration error, or reset a sync cursor to hide an expired feed. The helper backs up existing databases before applying new migrations.
 
 Track outreach through `external_message_id`, activity kind, time and outcome. Keep email bodies and mailbox credentials in the user's existing email system. Local notes are not a secret store. CSV export neutralizes spreadsheet formula prefixes; JSON is the lossless interchange format.
 
-For ledger cloud setup, follow [Connect the ledger CLI](../../references/cli.md#connect-the-ledger-cli-to-an-existing-project): create a scoped credential in the workspace, supply it through the process environment, verify the existing project with `connect`, then review `sync --dry-run`. An explicit ledger-ID selection keeps unrelated local records out of uploads. MCP OAuth credentials stay in the MCP client.
+For ledger cloud setup, follow [Connect the ledger CLI](references/portable/references/cli.md#connect-the-ledger-cli-to-an-existing-project): create a scoped credential in the workspace, supply it through the process environment, verify the existing project with `connect`, then review `sync --dry-run`. An explicit ledger-ID selection keeps unrelated local records out of uploads. MCP OAuth credentials stay in the MCP client.
 
 For recurring cloud changes, use the host's already connected AgentLinkOps tools when available. The standalone `sync` helper requires `AGENTLINKOPS_API_URL` and `AGENTLINKOPS_API_KEY` in its process environment (the `LINKTRAIL_` spellings are still accepted with a warning during the pilot compatibility window). Never request a key in chat or place it in command arguments, source files or CRM notes. Account connection and permissions are separate from local CRM utility. Explain unavailable access neutrally and preserve completed local work.
 
@@ -29,7 +33,7 @@ Sync updates `cloud_state` on placements and preserves local status, notes and o
 Recipes are optional. Choose `agentlinkops agent setup --recipe placement-reconciliation` before reading `../../references/recipes/placement-reconciliation.md` for an exact source and destination, retained evidence, checkpoints and optional monitoring. Removing the recipe preserves your local records and existing reconciliation process.
 
 For a draft-only file from an existing frozen report, read [portable ledger
-handoff](../../references/portable-ledger-handoff.md). It needs explicit customer
+handoff](references/portable/references/portable-ledger-handoff.md). It needs explicit customer
 workspace/project/site and external-ID mappings, verifies the report hash and
 refuses mismatched sites or conflicting output. It does not verify hosted grants,
 import into a vendor or send messages. Keep replied, suppressed and unknown facts
@@ -37,7 +41,20 @@ separate from monitoring state; a saved file does not establish destination
 readback or permission to send.
 
 When the user selects an existing local Outreach CRM with `projects/<project>/drafts`,
-use [local CRM draft handoff](../../references/local-crm-draft-handoff.md) for exact
+use [local CRM draft handoff](references/portable/references/local-crm-draft-handoff.md) for exact
 body/manifest saving, interrupted-save recovery and readback. This adapter preserves
 the complete original request and explicit site binding. It does not import contacts,
 check current sender authority, activate sequences or provide a native vendor API.
+
+## Several recipients on one hosted opportunity
+
+When the authenticated catalog lists `save_campaign_participation` and
+`record_campaign_participation_outcome`, the limited operator pilot can bind each
+recipient's saved contact, campaign and opaque source record to one existing
+opportunity. Read the participation and contact revisions before recording a dated
+source event. Reuse the event identity after interruption and read the saved result.
+A recipient reply or decline concerns that recipient; independent placement evidence
+and monitoring remain on the shared opportunity. Preserve its saved contact association and
+legacy reference. Do not duplicate watches or invent source URLs. If these commands
+are absent, keep the additional recipient records in the current CRM and report the
+held mapping. Sender credentials, bodies, sequences and suppression stay external.

package/skills/agentlinkops-crm/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: AgentLinkOps CRM
-  short_description: Manage the AgentLinkOps local backlink and outreach CRM, user-selected disavow lists, branded HTML reports and cloud eve
+  short_description: "Manage local CRM, disavow lists, reports and cloud event sync"
 policy:
   allow_implicit_invocation: true
 dependencies: