@aligndottech/cli 0.48.0 → 0.50.0

package/dist/commands/local.js

@@ -1,8 +1,15 @@
+import { existsSync as fileExists } from 'node:fs';
 import chalk from 'chalk';
 import { createConfigStore } from '../lib/config.js';
 import { createLocalDb } from '../lib/local-db.js';
+import { exportLedger, restoreLedger } from '../lib/share/ledger.js';
+import { sweepPending } from '../lib/share/pending.js';
 import { getLocalDbPath, initLocalMode, LOCAL_DB_SUFFIXES } from '../lib/local-mode.js';
 import { localValueRollup, renderValueReadout } from '../lib/value-rollup.js';
+import { forgetSourceData } from '../lib/sync/forget.js';
+import { isPurgeable, PURGEABLE_SOURCES, purgePreview } from '../lib/sync/purge.js';
+import { BACKFILL_SOURCES } from '../lib/mcp-backfill.js';
+import { refreshSummary } from '../lib/sync/summary.js';
 export function registerLocalCommand(program) {
     const local = program
         .command('local')
@@ -49,21 +56,77 @@ export function registerLocalCommand(program) {
     local
         .command('forget [connector]')
         .description('Remove saved read-only tokens (all, or one named connector)')
-        .action((connector) => {
+        .option('--purge', 'Also delete the items imported from that connector, except any you ratified, confirmed, captured by hand, acted on or judged. Asks first')
+        .option('--yes', 'With --purge: skip the question (needed when there is no terminal)')
+        .action(async (connector, opts) => {
+        sweepPending();
         const config = createConfigStore();
+        const env = config.getEnvironment('local');
+        const dbPath = env.mode === 'local-embedded' ? env.localDbPath : undefined;
+        // The launch summary lists connected sources; forgetting one must not leave it there.
+        const refresh = () => {
+            if (dbPath && fileExists(dbPath))
+                refreshSummary(dbPath, (id) => Boolean(config.getConnectorFields('local', id)?.['token']));
+        };
+        const refuse = (message) => { console.error(message); process.exitCode = 2; };
+        if (opts.purge && (!connector || !isPurgeable(connector))) {
+            // A purge across every source in one word, or of a name that is not a connector (cli, git, a typo),
+            // is not a thing to do by accident. Nothing is deleted and no token is forgotten.
+            refuse(`align local forget: --purge needs the name of a connected source (${PURGEABLE_SOURCES.join(', ')}), for example: align local forget slack --purge`);
+            return;
+        }
         if (!connector) {
             config.forgetAllConnectors('local');
+            for (const id of BACKFILL_SOURCES)
+                forgetSourceData(dbPath, id, { purge: false });
+            refresh();
             console.log('Removed every saved read-only token. Setup will ask again next time.');
             return;
         }
         // Distinguish "removed it" from "there was nothing there": silence on a no-op reads as
         // success, and leaves someone believing a credential is gone that was never stored.
-        if (!config.getConnectorFields('local', connector)) {
+        const had = Boolean(config.getConnectorFields('local', connector));
+        if (!had && !opts.purge) {
             console.log(`Nothing saved for ${connector}.`);
             return;
         }
-        config.forgetConnector('local', connector);
-        console.log(`Removed the saved token for ${connector}. Revoke it at the provider too if you are done with it.`);
+        if (opts.purge && dbPath && fileExists(dbPath)) {
+            const { deleted, kept } = purgePreview(dbPath, connector);
+            if (deleted > 0 && !opts.yes) {
+                const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+                if (!interactive) {
+                    refuse(`align local forget: --purge would delete ${deleted} ${connector} items (keeping ${kept}) and there is no terminal to ask in. Nothing was changed. Pass --yes to go ahead.`);
+                    return;
+                }
+                const { confirm } = await import('@clack/prompts');
+                if ((await confirm({ message: `Delete ${deleted} ${connector} items nobody has vouched for (keeping ${kept})? A copy is kept in the graph file for recovery.`, initialValue: false })) !== true) {
+                    console.log('Cancelled. Nothing was changed.');
+                    return;
+                }
+            }
+        }
+        // The graph first, in one transaction; the token only after it succeeded. A failure here leaves both as they were.
+        let r;
+        try {
+            r = forgetSourceData(dbPath, connector, { purge: opts.purge === true });
+        }
+        catch (e) {
+            console.error(`align local forget: ${e.message} The saved token was not removed.`);
+            process.exitCode = 1;
+            return;
+        }
+        if (had)
+            config.forgetConnector('local', connector);
+        refresh();
+        console.log(had
+            ? `Removed the saved token for ${connector}. Revoke it at the provider too if you are done with it.`
+            : `Nothing saved for ${connector}.`);
+        if (r.purged) {
+            console.log(`Deleted ${r.purged.deleted} ${connector} items nobody had vouched for, and kept ${r.purged.kept} (ratified, confirmed, captured by hand, acted on or judged).`);
+        }
+        else if (r.staying > 0) {
+            console.log(`${r.staying} ${connector} items stay in your graph. To delete the ones nobody has vouched for: align local forget ${connector} --purge`);
+        }
     });
     local
         .command('reset')
@@ -78,7 +141,11 @@ export function registerLocalCommand(program) {
         }
         const config = createConfigStore();
         const env = config.getEnvironment('local');
+        sweepPending();
         if (env.localDbPath) {
+            // The record of what this machine shared is NOT part of "the graph": without it a share could no longer be
+            // retracted. Carry it across the wipe.
+            const ledger = exportLedger(env.localDbPath);
             const db = createLocalDb(env.localDbPath);
             db.dropAll();
             db.close();
@@ -91,6 +158,11 @@ export function registerLocalCommand(program) {
                 if (existsSync(f))
                     rmSync(f);
             }
+            if (ledger.length > 0) {
+                createLocalDb(env.localDbPath).close();
+                restoreLedger(env.localDbPath, ledger);
+                console.log(`Kept your record of ${ledger.length} share${ledger.length === 1 ? '' : 's'} to your team, so you can still retract them (align share --retract).`);
+            }
         }
         config.clearLocalMode();
         // "Reset config" has to include the saved read-only tokens, or the promise is false in

package/dist/commands/local.js.map

@@ -1 +1 @@
-{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/commands/local.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/commands/local.ts"],"names":[],"mappings":"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"}

package/dist/commands/mark.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `align mark` - a person's judgement on what the local guardrail shows, kept on this machine.
+ *
+ *   align mark conflict <a> <b> real|false       a stored pair (from align get-conflicts)
+ *   align mark check <a> real|false [--files ...] a check hit; files default to the last check's set
+ *   align mark <a> replaces <b>                   a supersede judgement plus a supersedes link
+ *   align mark <a> not-a-decision [--undo]        out of ask and check retrieval, kept in the list
+ *   align mark <a> note "<text>"                  appends
+ *   align mark --list [<id>]  /  --undo           show or take back your own marks
+ *
+ * It makes no network call and asks no model. It is not a gate: a mark is a person's answer, so it
+ * runs without a terminal when its arguments are complete. Ratifying is a different act and stays
+ * in `align ratify`, which does insist on a terminal.
+ */
+import type { Command } from 'commander';
+import { type Judge } from '../lib/curation/judgements-db.js';
+import { type LastCheck } from '../lib/curation/last-check.js';
+export interface MarkCommandOptions {
+    files?: string[];
+    undo?: boolean;
+    list?: boolean;
+    force?: boolean;
+}
+export interface MarkCommandDeps {
+    out(line: string): void;
+    err(line: string): void;
+    graphPath(): string | undefined;
+    judge(): Promise<Judge>;
+    lastCheck(): Pick<LastCheck, 'files'> & Partial<Pick<LastCheck, 'decision_ids' | 'cwd' | 'head'>> | null;
+    /** A controller terminal on stdin: the marks that HIDE something are a person's at a keyboard. */
+    isTty(): boolean;
+    /** The git HEAD of the current directory, or null outside a repository. */
+    head(): Promise<string | null>;
+}
+export declare function runMarkCommand(args: string[], opts: MarkCommandOptions, deps: MarkCommandDeps): Promise<number>;
+export declare function registerMarkCommand(program: Command): void;
+//# sourceMappingURL=mark.d.ts.map

package/dist/commands/mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark.d.ts","sourceRoot":"","sources":["../../src/commands/mark.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAAkB,KAAK,KAAK,EAAqC,MAAM,kCAAkC,CAAC;AAEjH,OAAO,EAAW,KAAK,SAAS,EAAiB,MAAM,+BAA+B,CAAC;AAGvF,MAAM,WAAW,kBAAkB;IAAG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;AAEzG,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,IAAI,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IACzG,kGAAkG;IAClG,KAAK,IAAI,OAAO,CAAC;IACjB,2EAA2E;IAC3E,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChC;AA2BD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDrH;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoB1D"}

package/dist/commands/mark.js

@@ -0,0 +1,105 @@
+import chalk from 'chalk';
+import { applyJudgement, MarkError, parseMarkArgs } from '../lib/curation/mark.js';
+import { agentLabel, quote } from '../lib/curation/text.js';
+import { existingTitles, listJudgements } from '../lib/curation/judgements-db.js';
+import { defaultJudge } from '../lib/curation/judge.js';
+import { gitHead, readLastCheck } from '../lib/curation/last-check.js';
+import { localGraphPath } from '../lib/sync/real-env.js';
+const LABEL = {
+    conflict_verdict: 'conflict', check_verdict: 'check hit', supersede: 'replaces', not_a_decision: 'not a decision', note: 'note',
+};
+function describe(r, titles) {
+    const name = (id) => quote(titles.get(id) ?? id);
+    const day = r.judged_at.slice(0, 10);
+    // An agent's mark is always said so, with its verdict: a hit hidden by an agent is never invisible.
+    const who = r.via === 'mcp' ? `marked ${r.value ?? r.kind.replace(/_/g, ' ')} by ${agentLabel(r.agent_id)} via MCP` : 'by you';
+    const what = r.kind === 'conflict_verdict' ? `${name(r.decision_id)} and ${name(r.counterpart_id ?? '')}: ${r.value === 'false' ? 'false alarm' : 'real conflict'}`
+        : r.kind === 'check_verdict' ? `${name(r.decision_id)}: ${r.value === 'false' ? 'false alarm' : 'real conflict'} for one set of files`
+            : r.kind === 'supersede' ? `${name(r.decision_id)} replaces ${name(r.counterpart_id ?? '')}`
+                : r.kind === 'not_a_decision' ? `${name(r.decision_id)}: not a decision`
+                    : `${name(r.decision_id)}: ${quote(r.note ?? '')}`;
+    return `${day}  ${LABEL[r.kind]}  ${what}  (${who})`;
+}
+const TTY_MESSAGE = 'This hides or replaces a decision, or takes a mark back, so it is a person\'s act and needs a terminal. Run it in your own terminal. (A terminal check is a speed bump, not proof: a program can open one. It keeps an agent\'s shell tool and a pipe from doing this by accident.)';
+/** The marks that make the guardrail show LESS, or declare a decision replaced. */
+function needsTerminal(a) {
+    return (a.action === 'check' && a.verdict === 'false') || a.action === 'not-a-decision' || a.action === 'replaces';
+}
+export async function runMarkCommand(args, opts, deps) {
+    const dbPath = deps.graphPath();
+    const needsGraph = () => {
+        deps.err('There is no local graph to mark on yet. Capture or connect something with `align capture` or `align connect` first.');
+        return 1;
+    };
+    try {
+        if (opts.list) {
+            if (!dbPath)
+                return needsGraph();
+            const judge = await deps.judge();
+            const rows = listJudgements(dbPath, judge.judgeId, args[0]);
+            if (rows.length === 0) {
+                deps.out(args[0] ? `No marks of yours name ${quote(args[0])}.` : 'No marks yet. `align mark --help` shows what you can mark.');
+                return 0;
+            }
+            const titles = existingTitles(dbPath, [...new Set(rows.flatMap((r) => [r.decision_id, ...(r.counterpart_id ? [r.counterpart_id] : [])]))]);
+            for (const r of rows)
+                deps.out(describe(r, titles));
+            return 0;
+        }
+        let files = opts.files && opts.files.length ? opts.files : undefined;
+        const draft = parseMarkArgs(args, files);
+        if (draft.action === 'check' && files === undefined) {
+            // The last check is a default only for the decision it covered, in the directory it ran in.
+            const last = deps.lastCheck();
+            if (last && last.decision_ids?.includes(draft.id) && last.cwd === process.cwd() && (last.head ?? null) === (await deps.head()))
+                files = last.files;
+            else {
+                deps.err(last
+                    ? 'The last `align check` did not cover that decision in this directory, at this commit, so its files are not a default for it. Pass the files: align mark check <id> real|false --files <file>...'
+                    : 'There is no last `align check` to take the files from. Pass them: align mark check <id> real|false --files <file>...');
+                return 2;
+            }
+        }
+        const action = draft.action === 'check' ? { ...draft, files: files ?? [] } : draft;
+        if (!dbPath)
+            return needsGraph();
+        // Undo needs one too: otherwise a shell could take back a person's verdict and then have an agent write its own.
+        if ((opts.undo || opts.force || needsTerminal(action)) && !deps.isTty()) {
+            deps.err(TTY_MESSAGE);
+            return 1;
+        }
+        const outcome = applyJudgement({ dbPath, judge: await deps.judge(), origin: { via: 'cli' } }, action, { undo: opts.undo, force: opts.force });
+        deps.out(outcome.text);
+        return 0;
+    }
+    catch (e) {
+        if (e instanceof MarkError) {
+            deps.err(e.message);
+            return e.code === 'usage' ? 2 : 1;
+        }
+        throw e;
+    }
+}
+export function registerMarkCommand(program) {
+    program
+        .command('mark [args...]')
+        .description('Record your judgement on what the guardrail shows: a conflict real or false, a replacement, "not a decision", a note. Stays on this machine.')
+        .option('--files <paths...>', 'For a check hit: the files the check covered (default: the last `align check`)')
+        .option('--undo', 'Take back your own mark')
+        .option('--force', 'Replace a decision that is ratified or confirmed (at a terminal)')
+        .option('--list', 'Show your marks (optionally those naming one decision id)')
+        .action(async (args, opts) => {
+        const code = await runMarkCommand(args, opts, {
+            out: (l) => console.log(l),
+            err: (l) => console.error(chalk.red(l)),
+            graphPath: () => localGraphPath(),
+            judge: defaultJudge,
+            lastCheck: readLastCheck,
+            isTty: () => Boolean(process.stdin.isTTY),
+            head: gitHead,
+        });
+        if (code !== 0)
+            process.exitCode = code;
+    });
+}
+//# sourceMappingURL=mark.js.map

package/dist/commands/mark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark.js","sourceRoot":"","sources":["../../src/commands/mark.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAmB,SAAS,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAiC,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACjH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAkB,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAgBzD,MAAM,KAAK,GAA2B;IACpC,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM;CAChI,CAAC;AAEF,SAAS,QAAQ,CAAC,CAAe,EAAE,MAA2B;IAC5D,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,oGAAoG;IACpG,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/H,MAAM,IAAI,GACR,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,EAAE;QACtJ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,uBAAuB;YACtI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE;gBAC5F,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,kBAAkB;oBACxE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACrD,OAAO,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,GAAG,GAAG,CAAC;AACvD,CAAC;AAED,MAAM,WAAW,GAAG,qRAAqR,CAAC;AAE1S,mFAAmF;AACnF,SAAS,aAAa,CAAC,CAAa;IAClC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,gBAAgB,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC;AACrH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc,EAAE,IAAwB,EAAE,IAAqB;IAClG,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,UAAU,GAAG,GAAW,EAAE;QAC9B,IAAI,CAAC,GAAG,CAAC,qHAAqH,CAAC,CAAC;QAChI,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,MAAM;gBAAE,OAAO,UAAU,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,4DAA4D,CAAC,CAAC;gBAC/H,OAAO,CAAC,CAAC;YACX,CAAC;YACD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3I,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YACpD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACpD,4FAA4F;YAC5F,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9B,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;iBAC9I,CAAC;gBACJ,IAAI,CAAC,GAAG,CAAC,IAAI;oBACX,CAAC,CAAC,iMAAiM;oBACnM,CAAC,CAAC,sHAAsH,CAAC,CAAC;gBAC5H,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACnF,IAAI,CAAC,MAAM;YAAE,OAAO,UAAU,EAAE,CAAC;QACjC,iHAAiH;QACjH,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACxE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9I,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,8IAA8I,CAAC;SAC3J,MAAM,CAAC,oBAAoB,EAAE,gFAAgF,CAAC;SAC9G,MAAM,CAAC,QAAQ,EAAE,yBAAyB,CAAC;SAC3C,MAAM,CAAC,SAAS,EAAE,kEAAkE,CAAC;SACrF,MAAM,CAAC,QAAQ,EAAE,2DAA2D,CAAC;SAC7E,MAAM,CAAC,KAAK,EAAE,IAAc,EAAE,IAAwB,EAAE,EAAE;QACzD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;YAC5C,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACvC,SAAS,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE;YACjC,KAAK,EAAE,YAAY;YACnB,SAAS,EAAE,aAAa;YACxB,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;YACzC,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/mcp.d.ts

@@ -1,6 +1,9 @@
 import type { Command } from 'commander';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { type EnvironmentConfig } from '../lib/config.js';
 import { createGatewayClient } from '../lib/gateway-client.js';
+import { type ShareToolContext } from '../lib/mcp/share-tool.js';
+import { type MarkToolContext } from '../lib/mcp/mark-tool.js';
 export declare const ALIGN_MCP_INSTRUCTIONS: string;
 /**
  * Server instructions for the environment actually being served.
@@ -19,7 +22,7 @@ export declare function instructionsFor(env: EnvironmentConfig): string;
  */
 export declare function toolSchemasFor(env: EnvironmentConfig): typeof TOOL_SCHEMAS;
 export declare function serializeMcpResult(result: unknown): string;
-export declare function dispatchTool(name: string, args: Record<string, unknown> | undefined, client: ReturnType<typeof createGatewayClient>, env: EnvironmentConfig, createdBefore?: string): Promise<unknown>;
+export declare function dispatchTool(name: string, args: Record<string, unknown> | undefined, client: ReturnType<typeof createGatewayClient>, env: EnvironmentConfig, createdBefore?: string, toolCtx?: MarkToolContext & Pick<ShareToolContext, 'share'>): Promise<unknown>;
 /**
  * ALI-949: did this tool call hand the agent a real answer from the graph? The three tools
  * an agent reaches for to GET something (ask, search, check) count; a non-empty conflicts
@@ -38,7 +41,10 @@ export declare function isFirstUsefulToolResult(name: string, result: unknown):
  * make the agent the usual asker. The once-per-install guard is recordFunnelStage's, shared
  * with `align ask`; fired without await so the tool response never waits on telemetry.
  */
-export declare function createCallToolHandler(client: ReturnType<typeof createGatewayClient>, env: EnvironmentConfig, createdBefore?: string): (request: {
+export declare function createCallToolHandler(client: ReturnType<typeof createGatewayClient>, env: EnvironmentConfig, createdBefore?: string, ctx?: {
+    clientInfo?: () => MarkToolContext['clientInfo'];
+    judge?: MarkToolContext['judge'];
+}): (request: {
     params: {
         name: string;
         arguments?: Record<string, unknown>;
@@ -49,7 +55,140 @@ export declare function createCallToolHandler(client: ReturnType<typeof createGa
         text: string;
     }>;
 }>;
+/**
+ * Installs the CallTool handler on `server`. The one place the MCP `initialize` request's
+ * `clientInfo` is read, so a tool that attributes its writes to the calling agent (align_mark)
+ * gets it from the protocol and not from anything the agent could type into an argument.
+ */
+export declare function wireCallTool(server: Server, client: ReturnType<typeof createGatewayClient>, env: EnvironmentConfig, createdBefore?: string, judge?: MarkToolContext['judge']): void;
 export declare const TOOL_SCHEMAS: ({
+    readonly name: "align_backfill";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+    };
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly source: {
+                readonly type: "string";
+                readonly enum: readonly ["github", "jira", "confluence", "slack", "teams", "gitlab", "linear", "notion"];
+                readonly description: "Which connected source to read from";
+            };
+            readonly since: {
+                readonly type: "string";
+                readonly description: "How far back: 30d, 2w, 6m, 1y or all. Default 180 days. A ceiling per source still applies";
+            };
+        };
+        readonly required: readonly ["source"];
+        readonly additionalProperties: false;
+    };
+} | {
+    readonly name: "align_scope";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+    };
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["view", "set"];
+                readonly description: "view: show the scopes. set: change one source's scope";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly enum: readonly ["github", "jira", "confluence", "slack", "teams", "gitlab", "linear", "notion", "zoom"];
+                readonly description: "With \"set\": which connected source to change";
+            };
+            readonly scope: {
+                readonly type: "string";
+                readonly enum: readonly ["yours", "team"];
+                readonly description: "With \"set\": \"yours\" goes back to only the user's own items. \"team\" is implied by passing the source's value below";
+            };
+            readonly repo: {
+                readonly type: "string";
+                readonly description: "GitHub: the repo as owner/repo";
+            };
+            readonly projects: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Jira: project keys, for example [\"ALI\",\"OPS\"]";
+            };
+            readonly teams: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Linear: team keys, for example [\"ENG\"]";
+            };
+            readonly gitlab_project: {
+                readonly type: "string";
+                readonly description: "GitLab: the project id or group/project path";
+            };
+            readonly spaces: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Confluence: space keys, for example [\"ENG\"]";
+            };
+        };
+        readonly required: readonly ["action"];
+        readonly additionalProperties: false;
+    };
+} | {
+    readonly name: "align_sync";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+    };
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["status", "run", "classify_estimate"];
+                readonly description: "What to do";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly enum: readonly ["github", "jira", "confluence", "slack", "teams", "gitlab", "linear", "notion"];
+                readonly description: "With \"run\": only this source. Default: every connected source";
+            };
+            readonly max: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 1000;
+                readonly description: "With \"classify_estimate\": how many items the person would classify (default 25)";
+            };
+        };
+        readonly required: readonly ["action"];
+        readonly additionalProperties: false;
+    };
+} | {
+    readonly name: "align_share";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+    };
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+} | {
+    readonly name: "align_mark";
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+    };
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+} | {
     name: string;
     annotations: {
         readonly readOnlyHint: true;

package/dist/commands/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,OAAO,EAAqB,KAAK,iBAAiB,EAAgB,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAyC/D,eAAO,MAAM,sBAAsB,QAGlC,CAAC;AA+CF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAS9D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,YAAY,CAkC1E;AAOD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAE1D;AAMD,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,MAAM,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAC9C,GAAG,EAAE,iBAAiB,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAoKlB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAU9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAC9C,GAAG,EAAE,iBAAiB,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAS7I;AAmBD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+JxB,CAAC;AAkDF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAWtF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoEzD"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"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"}