agentlinkops 0.6.13 → 0.6.16

package/shared/observation-event.js

@@ -6,7 +6,7 @@ export function eventSnapshot(state) {
     rel: (item.rel || []).slice(0, 20),
   }));
   return {
-    schema_version: 1, target_scope: state.target_scope,
+    schema_version: 1, display_state: state.pipeline?.intent==='prospect' && !state.wasEverPresent ? 'prospect' : ['confirmed_missing','suspected_missing'].includes(state.state) && !state.wasEverPresent ? 'unverified' : state.state||'unknown', was_ever_present:state.wasEverPresent === true, intent:state.pipeline?.intent??'earned', target_scope: state.target_scope,
     check_state: latest.state ?? 'unknown', link_signature: latest.linkSignature ?? null,
     checker_version: latest.evidence?.checkerVersion ?? null,
     // Hash the captured document, not the enclosing R2 receipt object. Older events

package/shared/onboarding.js

@@ -0,0 +1,20 @@
+import {z} from 'zod';
+
+export const initialOnboarding = () => ({version:1,revision:0,step:'website',projectId:null,gsc:null,returnTo:null,completedAt:null});
+export const onboardingState = z.object({
+  version:z.literal(1),revision:z.number().int().nonnegative(),step:z.enum(['website','google','finish','complete']),
+  projectId:z.string().nullable(),gsc:z.enum(['connected','later']).nullable(),returnTo:z.string().nullable(),completedAt:z.string().nullable(),
+});
+export const onboardingResponse = z.object({required:z.boolean(),state:onboardingState.nullable()});
+
+// Keep only the two existing account-return destinations. Never persist an OAuth code,
+// bearer, arbitrary URL or user-supplied permission scope in workspace metadata.
+export function onboardingReturnTo(value) {
+  if(typeof value!=='string'||!value.startsWith('#/'))return null;
+  const [route,query]=value.slice(2).split('?'),params=new URLSearchParams(query);
+  if(route==='workspace'&&params.get('section')==='invitations')return '#/workspace?section=invitations';
+  const clientId=params.get('clientId');
+  if(route==='access'&&params.get('section')==='grants'&&params.getAll('clientId').length===1&&clientId&&clientId.length<=2048&&!/[\s\u0000-\u001f\u007f]/.test(clientId))
+    return `#/access?${new URLSearchParams({section:'grants',clientId})}`;
+  return null;
+}

package/shared/response-contract.js

@@ -1,19 +1,32 @@
+import {onboardingResponse} from './onboarding.js';
+import {internalLinkPreviewOutput,internalLinkSnapshotOutput,internalLinkListOutput,internalLinkQueryOutput} from './internal-links-contract.js';
+import {profileHistoryOutput,profileHistoryRecordsOutput} from './analytics-history-contract.js';
+import {classificationMetadataResponse,classificationMetadataWriteResponse,classificationMetadataOccurrenceResponse,classificationResponse,classificationHistoryResponse,classificationQuoteResponse,classificationJobResponse} from './classification-contract.js';
 import {chronologyResponse,assuranceResponse} from './monitoring-read-contract.js';
 import {lifecycleOutput} from './lifecycle-contract.js';
+import {contactResponses} from './contact-record-contract.js';
+import {prospectResponses} from './campaign-prospect-contract.js';
+import {campaignOutcomeResponses} from './campaign-outcome-contract.js';
 import {searchConnectionsResponse,searchRowsResponse,searchSyncResponse,searchPropertiesResponse,searchStartResponse,searchConnection,searchImportResponse} from './search-connection-contract.js';
+import {linkSummaryResponse} from './link-summary-contract.js';
+import {linkCategoryFields,linkLabelledWatchResponse,linkLabelledWatchesResponse} from './link-category-contract.js';
+export {linkSummaryResponse};
 import {z} from 'zod';
 export const objectResponse=z.looseObject({});
 export const pageResponse=z.looseObject({items:z.array(objectResponse),next_cursor:z.string().nullable().optional()});
-export const watchResponse=z.looseObject({id:z.string(),source_url:z.string(),target_url:z.string(),state:z.string(),observation_state:objectResponse});
+// Category fields share the documented contract while remaining additive for older
+// deployments. List rows may be concise; detailed watch requirements stay separate.
+export const watchPageResponse=pageResponse.extend({items:z.array(z.looseObject(linkCategoryFields))});
+export const watchResponse=z.looseObject({...linkCategoryFields,id:z.string(),source_url:z.string(),target_url:z.string(),state:z.string(),observation_state:objectResponse});
 export const targetResponse=z.looseObject({id:z.string(),url:z.string(),state:z.string(),observation_state:objectResponse});
 export const historyResponse=z.looseObject({items:z.array(z.looseObject({id:z.string(),state:z.string(),checked_at:z.string(),result:objectResponse})),next_cursor:z.string().nullable().optional()});
 export const jobResponse=z.looseObject({id:z.string(),state:z.enum(['queued','running','succeeded','failed','cancelled'])});
 export const observationEvent=z.looseObject({id:z.string(),data:objectResponse});
-export const eventFeedResponse=z.looseObject({events:z.array(observationEvent),next_cursor:z.string(),has_more:z.boolean()});
+export const eventFeedResponse=z.looseObject({events:z.array(observationEvent),next_cursor:z.string().nullable(),has_more:z.boolean()});
 export const linkChangeReportResponse=z.looseObject({schema_version:z.literal(1),workspace_id:z.string(),project_id:z.string(),coverage_scope:z.literal('retained_event_feed'),
   from:z.string(),as_of:z.string(),through_sequence:z.number().int().nonnegative(),count:z.number().int().nonnegative(),
   limit:z.literal(500),truncated:z.boolean(),complete:z.boolean(),retention_limited:z.boolean(),scan_limit:z.literal(10000),scan_limited:z.boolean(),
-  events:z.array(z.looseObject({id:z.string(),workspace_id:z.string(),project_id:z.string(),type:z.enum(['placement_acquired','placement_recovered','placement_lost']),created_at:z.string()})).max(500)});
+  events:z.array(z.looseObject({id:z.string(),workspace_id:z.string(),project_id:z.string(),type:z.enum(['placement_acquired','placement_recovered','placement_lost','prospect_won']),created_at:z.string()})).max(500)});
 export const usageResponse=z.looseObject({
   workspace_id:z.string(),period:z.string().regex(/^\d{4}-\d{2}$/),plan:z.string(),
   check_reservations:z.looseObject({reserved:z.number().nonnegative(),consumed:z.number().nonnegative(),released:z.number().nonnegative()}),
@@ -42,11 +55,27 @@ export const candidateMonitoringResponse=z.looseObject({
 });
 /** Network boundary shared by the console and command adapters. Unknown fields survive evolution. */
 export function restResponseContract(path,method='GET') {
+  const contactCommand=path.split('?')[0].match(/^\/v1\/commands\/([^/]+)$/)?.[1];
+  const campaignResponse=prospectResponses[contactCommand]??campaignOutcomeResponses[contactCommand]??contactResponses[contactCommand];
+  if(method==='POST'&&campaignResponse)return campaignResponse;
+  if(/^\/v1\/projects\/[^/]+\/classification-metadata(?:\/(definitions|settings|occurrences))?(?:\?|$)/.test(path))return method==='GET'?(path.split('?')[0].endsWith('/occurrences')?classificationMetadataOccurrenceResponse:classificationMetadataResponse):classificationMetadataWriteResponse;
+  if(/^\/v1\/watches\/[^/]+\/classification\/history(?:\?|$)/.test(path))return classificationHistoryResponse;
+  if(/^\/v1\/watches\/[^/]+\/classification\/quote(?:\?|$)/.test(path))return classificationQuoteResponse;
+  if(/^\/v1\/watches\/[^/]+\/classification\/(?:classify|jobs\/[^/?]+(?:\/reconcile)?)(?:\?|$)/.test(path))return classificationJobResponse;
+  if(/^\/v1\/watches\/[^/]+\/classification(?:\/prepare)?(?:\?|$)/.test(path))return classificationResponse;
   const pathname=path.split('?')[0];
+  if(pathname==='/v1/onboarding')return onboardingResponse;
+  if(pathname==='/v1/internal-links/preview'&&method==='POST')return internalLinkPreviewOutput;
+  if(pathname==='/v1/internal-links/snapshots')return method==='GET'?internalLinkListOutput:internalLinkSnapshotOutput;
+  if(/^\/v1\/internal-links\/snapshots\/[^/]+\/query$/.test(pathname))return internalLinkQueryOutput;
+  if(/^\/v1\/internal-links\/snapshots\/[^/]+(?:\/process)?$/.test(pathname))return internalLinkSnapshotOutput;
+  if(method==='PUT' && /^\/v1\/watches\/[^/]+\/type$/.test(pathname))return linkLabelledWatchResponse;
+  if(method==='POST' && pathname==='/v1/watches/bulk-labels')return linkLabelledWatchesResponse;
+  if(['POST','DELETE'].includes(method) && /^\/v1\/watches\/[^/]+\/tags(?:\/[^/]+)?$/.test(pathname))return linkLabelledWatchesResponse;
   if(method==='POST' && /^\/v1\/discovery\/runs\/[^/]+\/verification-batches$/.test(pathname))return candidateVerificationBatchResponse;
   if(method==='GET' && /^\/v1\/discovery\/verification-batches\/[^/]+$/.test(pathname))return candidateVerificationBatchResponse;
   if(method==='POST' && /^\/v1\/discovery\/verifications\/[^/]+\/monitor$/.test(pathname))return candidateMonitoringResponse;
-  if(pathname==='/v1/search-connections'&&method==='GET')return searchConnectionsResponse;
+  if(pathname==='/v1/search-connections'&&method==='GET')return /[?&]all=1(?:&|$)/.test(path)?z.looseObject({websites:z.array(z.looseObject({project:z.looseObject({id:z.string()})}))}):searchConnectionsResponse;
   if(pathname==='/v1/search-connections/start'&&method==='POST')return searchStartResponse;
   if(/^\/v1\/search-connections\/[^/]+\/rows$/.test(pathname)&&method==='GET')return searchRowsResponse;
   if(/^\/v1\/search-connections\/[^/]+\/properties$/.test(pathname)&&method==='GET')return searchPropertiesResponse;
@@ -61,9 +90,13 @@ export function restResponseContract(path,method='GET') {
   if(/^\/v1\/(?:watches|targets)\/[^/]+\/history$/.test(pathname))return historyResponse;
   if(/^\/v1\/watches\/[^/]+$/.test(pathname))return watchResponse;
   if(/^\/v1\/targets\/[^/]+$/.test(pathname))return targetResponse;
-  if(['/v1/watches','/v1/targets','/v1/projects','/v1/exports/watches'].includes(pathname))return pageResponse;
+  if(['/v1/watches','/v1/exports/watches'].includes(pathname))return watchPageResponse;
+  if(['/v1/targets','/v1/projects'].includes(pathname))return pageResponse;
   if(pathname==='/v1/usage')return usageResponse;
   if(pathname==='/v1/reports/link-changes')return linkChangeReportResponse;
+  if(pathname==='/v1/reports/history')return profileHistoryOutput;
+  if(pathname==='/v1/reports/history/records')return profileHistoryRecordsOutput;
+  if(pathname==='/v1/reports/summary')return linkSummaryResponse;
   if(['/v1/events','/v1/target-events'].includes(pathname))return eventFeedResponse;
   if(/^\/v1\/(?:jobs|target-jobs)\/[^/]+$/.test(pathname))return jobResponse;
   return objectResponse;

package/shared/search-connection-contract.js

@@ -1,4 +1,5 @@
 import {z} from 'zod';
+import {browsePageOutput} from './table-page-contract.js';
 const text=z.string(),nullable=text.nullable();
 export const searchConnection=z.looseObject({
  id:text,project_id:text,provider:z.enum(['google','bing']),status:text,property:nullable,
@@ -11,7 +12,7 @@ export const searchProviderRow=z.discriminatedUnion('kind',[
  z.looseObject({...rowMeta,kind:z.literal('search_performance'),page:text,query:text,clicks:z.number().nonnegative(),impressions:z.number().nonnegative(),ctr:z.number().nonnegative(),position:z.number().nonnegative(),startDate:text,endDate:text}),
  z.looseObject({...rowMeta,kind:z.literal('backlinks'),source_url:text,target_url:text,anchor:nullable,supplier:z.literal('bing_webmaster_tools'),verification_status:z.literal('unverified')}),
 ]);
-export const searchRowsResponse=z.looseObject({connection:searchConnection,rows:z.array(searchProviderRow),nextCursor:nullable});
+export const searchRowsResponse=z.looseObject({...browsePageOutput,connection:searchConnection,rows:z.array(searchProviderRow),nextCursor:nullable});
 export const searchSyncResponse=z.looseObject({connection:searchConnection,rowCount:z.number().int().nonnegative()});
 export const searchPropertiesResponse=z.looseObject({properties:z.array(z.looseObject({property:text,permission:text}))});
 export const searchStartResponse=z.looseObject({authorizationUrl:z.url(),expiresAt:text});

package/shared/table-page-contract.js

@@ -0,0 +1,13 @@
+import {z} from 'zod';
+const filter=z.strictObject({column:z.string().min(1).max(80),operator:z.enum(['contains','is','is_not','empty']),value:z.string().max(500)});
+export const browsePageInput={
+ browse:z.boolean().optional().describe('Server-sorted authorized saved rows; omit for legacy paging.'),
+ sort:z.string().min(1).max(80).optional().describe('Allowlisted saved-field identifier.'),
+ order:z.enum(['asc','desc']).optional().describe('Sort direction; stable ID ties, nulls last.'),
+ q:z.string().max(500).optional().describe('Literal search of supported saved fields.'),
+ table_filters:z.union([z.string().max(8192),z.array(filter).max(12)]).optional().describe('Up to 12 allowlisted column filters before paging.'),
+};
+export const browseCursor=z.string().min(1).max(16384);
+const count=z.number().int().nonnegative().nullable();
+export const browsePageOutput={total:count.optional(),has_more:z.boolean().optional(),next_cursor:browseCursor.nullable().optional(),
+ page:z.strictObject({limit:z.number().int().positive(),sort:z.string(),order:z.enum(['asc','desc']),total:count,query_scope:z.literal('server_dataset'),nulls:z.literal('last')}).optional()};

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

@@ -0,0 +1,290 @@
+{
+  "schemaVersion": 1,
+  "skill": "agentlinkops-assets",
+  "pack": "product",
+  "contractSha256": "e3d29a169dd1ecae2db26b22ab666419c4057e84831653df655f04ae61725e93",
+  "sourceManifest": [
+    {
+      "path": "references/cli.md",
+      "sha256": "7b665f9d9b60cdab1f0238b71500f8389e0a6df4ea9777db69af6627a000a766"
+    },
+    {
+      "path": "references/disavow.md",
+      "sha256": "f8a2ad2c779e15547c6cf6a199b1d4af18ad2ef2c0aa8f27094c00f366c55aaa"
+    },
+    {
+      "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/report.py",
+      "sha256": "c7088c3314d0453d62e8a70f0c80f535b219b2ea127ca7d1c0731b216a9cb602"
+    },
+    {
+      "path": "skills/agentlinkops-assets/SKILL.md",
+      "sha256": "c7a16a272103c062c1a846f4a5af23a89b5c06dacd4712bbfa3b5d68c912aed0"
+    },
+    {
+      "path": "skills/agentlinkops-assets/agents/openai.yaml",
+      "sha256": "ee49f3058b6fb130d8865c4811231579d65c2e58ac13f30cd010c317c1702504"
+    },
+    {
+      "path": "templates/campaigns.v1.json",
+      "sha256": "768e1610d64b82a4e5872c301eb2a537705821b2f01e9f2265c8056f7da4a496"
+    }
+  ],
+  "members": [
+    {
+      "path": "SKILL.md",
+      "sha256": "25dba1dbed4e524408dd41794eb7fb7c56c7334e3118b6b108d363534365a0d9"
+    },
+    {
+      "path": "agents/openai.yaml",
+      "sha256": "ee49f3058b6fb130d8865c4811231579d65c2e58ac13f30cd010c317c1702504"
+    },
+    {
+      "path": "references/portable/references/cli.md",
+      "sha256": "55ad759a920ed5bb683b0354739b7a929a0d733e987c6164977ea466ff606955"
+    },
+    {
+      "path": "references/portable/references/disavow.md",
+      "sha256": "47b4b335f7695209ad0758fc19f3b23b38792032a6850277e563a9b7d80eabf1"
+    },
+    {
+      "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/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/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": "SKILL.md",
+      "target": "../../references/recipes/internal-link-improvement.md",
+      "kind": "optional-selected",
+      "selection": "agentlinkops agent setup --recipe internal-link-improvement"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "../../references/recipes/sourced-linkable-asset.md",
+      "kind": "optional-selected",
+      "selection": "agentlinkops agent setup --recipe sourced-linkable-asset"
+    },
+    {
+      "from": "SKILL.md",
+      "target": "references/portable/references/cli.md",
+      "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-assets/SKILL.md

@@ -10,6 +10,8 @@ Preserve the project's rendering and routing conventions. Inspect nearby pages b
 
 Write plainly and specifically. Remove repetition and generic filler without deleting necessary evidence. Add internal links only where the destination answers the reader's next relevant question; inspect the actual routes before linking. Check for an existing competing page before creating a new URL.
 
-Use the site's existing validation commands appropriate to the change. Record the final target URL, reader benefit and evidence in the customer's chosen files, CRM or other record system. The bundled local CRM is optional; use [its contract](../../references/cli.md) only when the customer chooses that store. A completed local edit does not establish that the page is deployed or that a publisher accepted it.
+Use the site's existing validation commands appropriate to the change. Record the final target URL, reader benefit and evidence in the customer's chosen files, CRM or other record system. The bundled local CRM is optional; use [its contract](references/portable/references/cli.md) only when the customer chooses that store. A completed local edit does not establish that the page is deployed or that a publisher accepted it.
 
 Recipes are optional. Choose `agentlinkops agent setup --recipe sourced-linkable-asset` before reading `../../references/recipes/sourced-linkable-asset.md` for draft review receipts and publication state. Select `--recipe site-context-brief` separately before reading that recipe if the audience or evidence needs clarification. Your own brief and editorial process can serve the same task.
+
+For an optional internal-link plan, select `agentlinkops agent setup --recipe internal-link-improvement` before reading `../../references/recipes/internal-link-improvement.md`. It keeps source evidence, semantic choices, site edits, publication claims and independent verification separate. Supplied pages remain sufficient for a useful plan without hosted access.

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

@@ -1,5 +1,5 @@
 interface:
   display_name: AgentLinkOps Assets
-  short_description: Improve a code-built site's resource, guide or research page for a specific backlink campaign, with sourced claims and u
+  short_description: "Improve sourced site pages for a specific backlink campaign"
 policy:
   allow_implicit_invocation: true