agentlinkops 0.6.10 → 0.6.11

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlinkops",
-  "version": "0.6.10",
+  "version": "0.6.11",
   "description": "Connect an agent to AgentLinkOps and run backlink work with it: the connect skill (views, the three discovery verbs, evidence rules), local ledger and campaign skills, a portable CRM, the source-cited content pipeline, user-managed disavow lists, HTML reports and monitoring-event sync.",
   "author": {
     "name": "AgentLinkOps"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlinkops",
-  "version": "0.6.10",
+  "version": "0.6.11",
   "description": "Connect an agent to AgentLinkOps and run backlink work with it: the connect skill (views, the three discovery verbs, evidence rules), local ledger and campaign skills, a portable CRM, the source-cited content pipeline, user-managed disavow lists, HTML reports and monitoring-event sync.",
   "author": {
     "name": "AgentLinkOps"

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to the `agentlinkops` package are recorded here. The version follows the
 plugin manifests in `.claude-plugin/` and `.codex-plugin/`.
 
+## 0.6.11 (2026-10-06)
+
+- Keep `check --json` stdout limited to observation rows. Send empty-ledger, not-due and filter notices to stderr.
+- Reject malformed ledger rows with line numbers and exit with status 2 before fetching or updating customer records.
+- Apply `--fail-on-unknown` to JSON and human output. Unknown observations remain nonfailing by default.
+- Detect duplicate placements across import batches and retain their original file line numbers.
+
 ## 0.6.10 (2026-10-06)
 
 Inspect the installed version's help before using selectors; older published versions

package/README.md

@@ -98,10 +98,10 @@ agentlinkops status
 the source page and appends an observation to the mirror. `status` names every entry whose
 observations disagree with its intent and proposes the edit; applying it is a commit you make.
 
-For ledger checks, exit codes are `0` when every expected link is present, `1` only
-when an expected link is observed absent with complete evidence, and `2` for a usage,
-configuration or ledger error. An unknown never fails the run.
-Pass `--fail-on-unknown` when your CI wants it to.
+Ledger checks return `0` when no expected placement is conclusively absent and `1` when
+an expected placement is observed absent with complete evidence. Unknown observations do
+not fail a run by default. Pass `--fail-on-unknown` to return `1` for an unknown result
+in text or JSON output. Usage, configuration and malformed-ledger errors return `2`.
 
 `agentlinkops doctor` verifies the ledger, the verifier self-test, cloud reachability and the
 token, and prints a fix line for anything that fails.

package/cli/client.js

@@ -5,7 +5,7 @@ export {CloudError} from './cloud-error.js';
 // A small HTTP client for the cloud. Scoped keys only; no human session ever reaches here.
 // DP-0036-T13: the CLI names itself so the usage counters can tell it from other REST callers.
 // The version follows the plugin manifests; bump it with them.
-export const CLI_VERSION = '0.6.10';
+export const CLI_VERSION = '0.6.11';
 export const CLI_USER_AGENT = `agentlinkops-cli/${CLI_VERSION}`;
 const MAX_ATTEMPTS = 3;
 const MAX_RETRY_WAIT_MS = 5_000;

package/cli/import.js

@@ -74,11 +74,14 @@ export async function readImport(path, {
   // chunks, so a placement repeated in two different parts of one file is still one candidate.
   const prepared = { accepted: [], rejected: [], duplicates: [] };
   const seen = new Map();
+  // Candidate identity includes the run. These bounded slices describe one preview, so keep
+  // its first-slice identity throughout the file or a repeated placement gets a new ID.
+  const previewRunId = `${runId}_0`;
   const chunks = [];
   for (let index = 0; index < rows.length; index += DISCOVERY_LIMITS.rows) chunks.push(index);
   for (const offset of chunks) {
     const part = await prepareImport({
-      runId: `${runId}_${offset / DISCOVERY_LIMITS.rows}`, workspaceId, projectId, supplier,
+      runId: previewRunId, workspaceId, projectId, supplier,
       rows: rows.slice(offset, offset + DISCOVERY_LIMITS.rows), target: targetUrl, scope,
       taskId: 'import_preview', retrievedAt: now, generatedAt: supplierGeneratedAt,
       seen, rowOffset: offset,

package/cli/main.js

@@ -115,8 +115,9 @@ const USAGE = `agentlinkops — a backlink ledger that lives in your repository
 Suppliers: ${SUPPLIER_NAMES.join(', ')}
 A preset is a convenience over --map, never a requirement.
 
-Exit codes: 0 every expected link present · 1 an expected link observed absent with complete
-evidence · 2 usage, configuration or ledger error. An unknown never fails.
+Exit codes: 0 no expected link conclusively absent · 1 an expected link observed absent with complete
+evidence · 2 usage, configuration or ledger error. Unknown is nonfailing by default;
+--fail-on-unknown returns 1 when any observation is unknown.
 
 Names: \`linktrail\` still runs this CLI, LINKTRAIL_* variables are still read, and an existing
 .linktrail/ directory is still used, each with a one-line notice, until the DP-0029 cutover.`;
@@ -586,10 +587,11 @@ export async function main(argv = process.argv.slice(2), { cwd = process.cwd(),
     }
 
     if (command === 'check') {
+      if (ledger.problems.length) { reportProblems(ledger.problems, 'ledger line(s)', err); return 2; }
       const state = await readState(config.paths.state);
       const selected = selectEntries(ledger.entries, { filter: args.filter === true ? null : args.filter });
       const entries = args.all ? selected : dueEntries(selected, lastCheckedMap(state));
-      if (!entries.length) { out(`nothing due (${plural(selected.length, 'entry', 'entries')} in scope; pass --all to recheck)`); return 0; }
+      if (!entries.length) { (args.json ? err : out)(`nothing due (${plural(selected.length, 'entry', 'entries')} in scope; pass --all to recheck)`); return 0; }
       if (!args.json) err(`checking ${plural(entries.length, 'entry', 'entries')}…`);
       const rows = await runCheck(entries, {
         concurrency: Number(args.concurrency ?? config.defaults.concurrency ?? DEFAULTS.concurrency),
@@ -603,8 +605,8 @@ export async function main(argv = process.argv.slice(2), { cwd = process.cwd(),
       await appendObservations(config.paths.observations, changed);
       await writeState(config.paths.state, applyRun(state, rows));
       const summary = summarize(entries, rows);
-      if (args.json) { out(rows.map(row => JSON.stringify(row)).join('\n')); return summary.exitCode; }
-      reportProblems(ledger.problems, 'ledger line(s)', out);
+      const exitCode = args['fail-on-unknown'] && summary.counts.unknown ? 1 : summary.exitCode;
+      if (args.json) { out(rows.map(row => JSON.stringify(row)).join('\n')); return exitCode; }
       for (const { entry, row } of summary.appeared) out(`APPEARED  ${entry.id}  ${entry.source}  (${row.occurrences} occurrence(s))`);
       for (const { entry, row } of summary.failures) out(`ABSENT    ${entry.id}  ${entry.source}  [${row.reason}]`);
       out(`\n${JSON.stringify(summary.counts)}`);
@@ -612,8 +614,7 @@ export async function main(argv = process.argv.slice(2), { cwd = process.cwd(),
       if (summary.counts.unknown) {
         out(`${plural(summary.counts.unknown, 'page')} could not be concluded. An unknown is not a lost link; run \`agentlinkops status\` for the reasons.`);
       }
-      if (args['fail-on-unknown'] && summary.counts.unknown) return 1;
-      return summary.exitCode;
+      return exitCode;
     }
 
     err(`unknown command: ${command}\n\n${USAGE}`);

package/cli/mcp-client.js

@@ -62,7 +62,7 @@ function retryDelay(error, attempt, now) {
 
 async function sdkClient({url, token, workspaceId, fetchImpl}) {
   const {Client, StreamableHTTPClientTransport} = await import('@modelcontextprotocol/client');
-  const client = new Client({name: 'agentlinkops-cli', version: '0.6.10'});
+  const client = new Client({name: 'agentlinkops-cli', version: '0.6.11'});
   const destination = new URL(url);
   const transport = new StreamableHTTPClientTransport(destination, {
     authProvider: {token: async () => token},
@@ -71,7 +71,7 @@ async function sdkClient({url, token, workspaceId, fetchImpl}) {
       if (target.href !== destination.href) fail('OAUTH_TOKEN_DESTINATION_MISMATCH');
       const headers = new Headers(init.headers ?? (input instanceof Request ? input.headers : undefined));
       if (workspaceId) headers.set('X-Workspace-ID', workspaceId);
-      headers.set('User-Agent', 'agentlinkops-cli/0.6.10');
+      headers.set('User-Agent', 'agentlinkops-cli/0.6.11');
       const response = await fetchImpl(input, {...init, headers, redirect: 'error', signal: AbortSignal.timeout(30000)});
       if (response.redirected || response.status >= 300 && response.status < 400
         || response.url && response.url !== destination.href) fail('OAUTH_TOKEN_DESTINATION_MISMATCH');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlinkops",
-  "version": "0.6.10",
+  "version": "0.6.11",
   "description": "Backlink checks with dated evidence and portable results, optional repository ledgers, supplier-export imports and sync to AgentLinkOps.",
   "author": "AgentLinkOps (https://agentlinkops.com)",
   "license": "Apache-2.0",

package/skills/agentlinkops-connect/references/agentlinkops.md

@@ -9,7 +9,7 @@ records. This page is the complete agent reference: the same text prints from
 full once per session, then use `describe` (or `exec describe` on MCP) for any command's exact schema.
 
 <!-- generated:skill-version begin (npm run generate:tools) -->
-Pack version 0.6.10. 139 commands in 15 toolsets.
+Pack version 0.6.11. 139 commands in 15 toolsets.
 <!-- generated:skill-version end -->
 
 ## Install and connect (once per machine)

package/skills/agentlinkops-crm/SKILL.md

@@ -6,7 +6,7 @@ allowed-tools: Read Bash(python3 ../../scripts/agentlinkops.py *) Bash(python3 .
 
 **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.
 
-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 exits 0 when all are present, 1 when one is observed absent with complete evidence, 2 on a usage or ledger error; an unknown never fails.
+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.