auden 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/commands/pull.d.ts

@@ -2,13 +2,19 @@ export declare const pullCommand: import("citty").CommandDef<{
     bundle: {
         type: "positional";
         description: string;
-        required: true;
+        required: false;
+        default: string;
     };
     out: {
         type: "string";
         description: string;
         default: string;
     };
+    once: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
     types: {
         type: "string";
         description: string;

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

@@ -1 +1 @@
-{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyHtB,CAAA"}
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../src/commands/pull.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4MtB,CAAA"}

package/dist/commands/pull.js

@@ -1,6 +1,8 @@
+import { createInterface } from 'node:readline/promises';
 import { defineCommand } from 'citty';
 import { resolveDashboardUrl, resolveToken } from '../config.js';
 import { defaultPullDir, pullBundleToDir } from '../context/pull.js';
+import { parseSelectionInput, subscribeBundles, } from '../docs/subscribe.js';
 import { createContextClient } from '../mcp/client.js';
 // Mirror the REST endpoint's (and MCP server's) MAX_LIMIT so an over-large
 // `--limit` fails client-side with a clear message instead of being rejected or
@@ -22,19 +24,25 @@ function parseTypesFlag(raw) {
 export const pullCommand = defineCommand({
     meta: {
         name: 'pull',
-        description: 'Pull a context bundle’s canonical items into a local directory as Markdown',
+        description: 'Pull a context bundle into this repo and subscribe so `auden sync` keeps it fresh',
     },
     args: {
         bundle: {
             type: 'positional',
-            description: 'Bundle slug to pull from (see "auden mcp" / the dashboard)',
-            required: true,
+            description: 'Bundle slug to pull (omit for an interactive picker of your bundles)',
+            required: false,
+            default: '',
         },
         out: {
             type: 'string',
-            description: 'Directory to write items into (default: .auden/context/<bundle>/)',
+            description: 'Directory to write items into (default: .auden/context/<bundle>/). Implies --once.',
             default: '',
         },
+        once: {
+            type: 'boolean',
+            description: 'Pull without subscribing — a one-off, not kept fresh by `auden sync`',
+            default: false,
+        },
         types: {
             type: 'string',
             description: 'Comma-separated item types to include (guide,document,reference,asset)',
@@ -62,12 +70,9 @@ export const pullCommand = defineCommand({
         },
     },
     async run({ args }) {
-        const bundle = args.bundle.trim();
-        if (!bundle) {
-            console.error('A non-empty bundle slug is required: `auden pull <bundle>`.');
-            process.exitCode = 1;
-            return;
-        }
+        // resolveToken honours the --token flag, then $AUDEN_TOKEN, then the stored
+        // config token (env-var credentials, PR #351). No positional-bundle guard
+        // here — a bare `auden pull` opens the interactive picker below.
         const token = await resolveToken(args.token);
         if (!token) {
             console.error('No Auden token configured. Get one from the dashboard (Settings → Developer → CLI Token), then run `auden init --token <token>` or pass `auden pull <bundle> --token <token>`.');
@@ -93,35 +98,124 @@ export const pullCommand = defineCommand({
             process.exitCode = 1;
             return;
         }
-        const dir = args.out.trim() || defaultPullDir(bundle, process.cwd());
-        const types = parseTypesFlag(args.types);
-        const query = args.query.trim();
         const client = createContextClient({ dashboardUrl, token });
-        let result;
-        try {
-            result = await pullBundleToDir(client, {
-                bundle,
-                query: query || undefined,
-                types: types.length > 0 ? types : undefined,
-                limit,
-            }, dir);
+        const cwd = process.cwd();
+        // Resolve which bundles to pull: an explicit positional, or an interactive
+        // picker when none is given (restores the discoverability the old
+        // `docs enable` picker provided).
+        const explicit = args.bundle.trim();
+        // --out targets a single directory, so it only makes sense with an explicit
+        // single bundle — reject it with the multi-select picker rather than
+        // silently ignoring it and writing to the default dirs.
+        if (args.out.trim() && !explicit) {
+            console.error('--out requires an explicit bundle: `auden pull <bundle> --out <dir>` (it cannot be combined with the interactive picker).');
+            process.exitCode = 1;
+            return;
         }
-        catch (err) {
-            console.error(err instanceof Error ? err.message : String(err));
+        let bundles;
+        if (explicit) {
+            bundles = [explicit];
+        }
+        else if (process.stdin.isTTY) {
+            try {
+                bundles = await pickBundles(client);
+            }
+            catch (err) {
+                console.error(err instanceof Error ? err.message : String(err));
+                process.exitCode = 1;
+                return;
+            }
+            if (bundles.length === 0) {
+                console.log('No bundles selected.');
+                return;
+            }
+        }
+        else {
+            console.error('A bundle slug is required: `auden pull <bundle>` (or run in an interactive terminal to pick).');
             process.exitCode = 1;
             return;
         }
-        const skipped = result.items.length - result.written.length;
-        console.log(`Pulled ${result.written.length} item(s) from "${bundle}" into ${dir}` +
-            (skipped > 0
-                ? ` (${skipped} item(s) without text content skipped, e.g. assets)`
-                : ''));
-        for (const path of result.written) {
-            console.log(`  ${path}`);
+        // A custom --out is inherently a one-off to a chosen location; subscribing
+        // there would be inconsistent (sync refreshes the default dir), so --out
+        // implies --once. A picker selection can target several bundles, so --out
+        // (single directory) doesn't apply to it.
+        const customOut = args.out.trim();
+        const subscribe = !args.once && !customOut;
+        const types = parseTypesFlag(args.types);
+        const query = args.query.trim();
+        let anyFailed = false;
+        const pulled = [];
+        for (const bundle of bundles) {
+            const dir = explicit && customOut ? customOut : defaultPullDir(bundle, cwd);
+            try {
+                const result = await pullBundleToDir(client, {
+                    bundle,
+                    query: query || undefined,
+                    types: types.length > 0 ? types : undefined,
+                    limit,
+                }, dir);
+                const skipped = result.items.length - result.written.length;
+                console.log(`Pulled ${result.written.length} item(s) from "${bundle}" into ${dir}` +
+                    (skipped > 0
+                        ? ` (${skipped} item(s) without text content skipped, e.g. assets)`
+                        : ''));
+                for (const path of result.written) {
+                    console.log(`  ${path}`);
+                }
+                if (result.items.length === 0) {
+                    console.log('  (bundle is empty or no items matched the filters)');
+                }
+                pulled.push(bundle);
+            }
+            catch (err) {
+                anyFailed = true;
+                console.error(`Failed to pull "${bundle}": ${err instanceof Error ? err.message : String(err)}`);
+            }
         }
-        if (result.items.length === 0) {
-            console.log('  (bundle is empty or no items matched the filters)');
+        // Subscribe the bundles that actually pulled, so `auden sync` keeps them
+        // fresh. Never blocks or fails the pull — the content is already on disk.
+        if (subscribe && pulled.length > 0) {
+            const result = await subscribeBundles(cwd, pulled);
+            if (!result.ok) {
+                const detail = result.reason === 'malformed-config'
+                    ? '.auden/config.json is malformed — fix or remove it'
+                    : result.reason === 'home-collision'
+                        ? 'run from inside a repository, not your home directory (where it would collide with ~/.auden/config.json)'
+                        : `could not write .auden/config.json${result.message ? ` (${result.message})` : ''}`;
+                console.warn(`  warning: pulled, but did not subscribe — ${detail}. Pass --once to silence.`);
+            }
+            else {
+                if (result.removedToken) {
+                    console.warn('  warning: removed a `token` field from .auden/config.json — this file is committed, so rotate that token from the dashboard if it may have been pushed.');
+                }
+                if (result.added.length > 0) {
+                    console.log(`Subscribed to ${result.added.join(', ')} — \`auden sync\` will keep ${result.added.length > 1 ? 'them' : 'it'} fresh. Pass --once next time to pull without subscribing.`);
+                }
+            }
         }
+        if (anyFailed)
+            process.exitCode = 1;
     },
 });
+/** List the caller's bundles and read one selection line from stdin. */
+async function pickBundles(client) {
+    const { bundles } = await client.listBundles();
+    const choices = bundles.map((b) => ({ slug: b.slug, name: b.name }));
+    if (choices.length === 0) {
+        console.log('You have no bundles yet. Create one in the dashboard (or capture context to the inbox), then re-run `auden pull`.');
+        return [];
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        console.log('Your bundles:');
+        choices.forEach((choice, i) => {
+            console.log(`  ${i + 1}. ${choice.slug}${choice.name ? ` (${choice.name})` : ''}`);
+        });
+        const answer = await rl.question('Pull which? (numbers or slugs, comma-separated; blank to cancel): ');
+        return parseSelectionInput(answer, choices);
+    }
+    finally {
+        rl.close();
+    }
+}
 //# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,gCA0DxB,CAAA"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,aAAa,gCAyFxB,CAAA"}

package/dist/commands/status.js

@@ -1,6 +1,8 @@
-import { readFile } from 'node:fs/promises';
+import { readdir, readFile } from 'node:fs/promises';
 import { defineCommand } from 'citty';
 import { AUDEN_CONFIG, AUDEN_GUIDES_FILE, AUDEN_QUEUE_DIR } from '../auden-paths.js';
+import { readRepoDocsConfig } from '../docs/repo-config.js';
+import { computeDocsStatus } from '../docs/status.js';
 import { notifyUpdateIfDue } from '../update/notice.js';
 import { readVerdictQueue } from '../verdict-queue.js';
 export const statusCommand = defineCommand({
@@ -48,6 +50,26 @@ export const statusCommand = defineCommand({
         const queue = await readVerdictQueue(AUDEN_QUEUE_DIR);
         const pendingCount = queue.actions.length;
         const invalidCount = queue.invalidFilePaths.length;
+        // Doc-bundle subscriptions for the current repo (cross-repo-docs). Read from
+        // the repo-level .auden/config.json (cwd), distinct from the home config
+        // above; `auden sync` keeps these bundles' content fresh under
+        // .auden/context/<bundle>/.
+        const cwd = process.cwd();
+        const repoDocs = await readRepoDocsConfig(cwd);
+        const docRows = repoDocs.malformed
+            ? []
+            : await computeDocsStatus(cwd, repoDocs.bundles, {
+                listDir: async (dir) => {
+                    try {
+                        return await readdir(dir);
+                    }
+                    catch (err) {
+                        if (err.code === 'ENOENT')
+                            return null;
+                        throw err;
+                    }
+                },
+            });
         console.log('Auden status:');
         if (projectName)
             console.log(`  project:  ${projectName}`);
@@ -57,6 +79,18 @@ export const statusCommand = defineCommand({
         if (invalidCount > 0) {
             console.log(`  invalid:  ${invalidCount} unreadable queue file(s) (cleaned on next sync)`);
         }
+        if (repoDocs.malformed) {
+            console.log('  docs:     .auden/config.json is malformed — fix or remove it');
+        }
+        else if (docRows.length > 0) {
+            console.log(`  docs:     ${docRows.length} subscribed bundle(s)`);
+            for (const row of docRows) {
+                const state = row.exists
+                    ? `${row.materialized} file(s)`
+                    : 'not yet pulled — run auden sync';
+                console.log(`              ${row.bundle} — ${state}`);
+            }
+        }
         // After the status output, never before it — the notice must not push the
         // thing the user asked for out of view. Self-suppressing off a TTY.
         await notifyUpdateIfDue();

package/dist/commands/status.js.map

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

package/dist/commands/sync.d.ts

@@ -19,5 +19,15 @@ export declare const syncCommand: import("citty").CommandDef<{
         description: string;
         default: false;
     };
+    docs: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    'no-docs': {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
 }>;
 //# sourceMappingURL=sync.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;EAoOtB,CAAA"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6QtB,CAAA"}

package/dist/commands/sync.js

@@ -3,7 +3,10 @@ import { unlink } from 'node:fs/promises';
 import { defineCommand } from 'citty';
 import { AUDEN_GUIDES_FILE, AUDEN_QUEUE_DIR } from '../auden-paths.js';
 import { readConfigToken, resolveDashboardUrl, resolveToken, writeConfigToken, } from '../config.js';
+import { readRepoDocsConfig } from '../docs/repo-config.js';
+import { formatDocsSyncLine, syncSubscribedDocs } from '../docs/sync-docs.js';
 import { extractConversationalFeedback } from '../feedback/extract.js';
+import { createContextClient } from '../mcp/client.js';
 import { pullGuideBundle } from '../rules/pull-bundle.js';
 import { buildSyncBatches } from '../sync-batches.js';
 import { postSyncBatch } from '../sync-client.js';
@@ -39,6 +42,16 @@ export const syncCommand = defineCommand({
             description: 'Extract conversational feedback without sending it to the dashboard',
             default: false,
         },
+        docs: {
+            type: 'boolean',
+            description: 'Force the docs phase (pull subscribed bundles) even if this run would otherwise skip it',
+            default: false,
+        },
+        'no-docs': {
+            type: 'boolean',
+            description: 'Skip the docs phase (pulling subscribed bundles) for this run',
+            default: false,
+        },
     },
     async run({ args }) {
         const queue = await readVerdictQueue(AUDEN_QUEUE_DIR);
@@ -182,6 +195,34 @@ export const syncCommand = defineCommand({
             const message = err instanceof Error ? err.message : String(err);
             console.warn(`  warning: ${message} — skipping.`);
         }
+        // Docs phase (cross-repo-docs Slice 1a): when this repo subscribes to doc
+        // bundles, pull each into .auden/context/<bundle>/ so subscribed repos stay
+        // fresh on the same heartbeat. Pull-only; --no-docs skips, --docs forces the
+        // hint even when nothing is subscribed. Never aborts the sync — a bundle's
+        // failure is reported and the others still run.
+        if (!args['no-docs']) {
+            const { bundles, malformed } = await readRepoDocsConfig(process.cwd());
+            if (malformed) {
+                console.warn('  warning: .auden/config.json is malformed — skipping docs. Fix or remove the file.');
+            }
+            else if (bundles.length === 0) {
+                if (args.docs) {
+                    console.log('  No doc bundles subscribed in this repo — run `auden pull <bundle>` to subscribe.');
+                }
+            }
+            else {
+                const docsClient = createContextClient({ dashboardUrl, token });
+                const { results } = await syncSubscribedDocs(docsClient, bundles, process.cwd());
+                // A docs pull reaching the server also proves the token — mark
+                // acceptance so a --token flag is still stored even if the guide-bundle
+                // pull above failed transiently.
+                if (results.some((r) => r.error === undefined))
+                    serverAccepted = true;
+                for (const result of results) {
+                    console.log(formatDocsSyncLine(result));
+                }
+            }
+        }
         if (serverAccepted && args.token.trim() && args.token.trim() !== storedToken) {
             try {
                 await writeConfigToken(args.token);

package/dist/commands/sync.js.map

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

package/dist/docs/repo-config.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Repo-level docs subscription config: `<repo>/.auden/config.json`.
+ *
+ * This is a DIFFERENT file from the machine-level `~/.auden/config.json` that
+ * `src/config.ts` owns. That one lives in the home directory, is chmod `0600`,
+ * and holds the bearer **token**. This one is repo-relative, meant to be
+ * committed to git, and holds only a repo's doc-bundle subscription
+ * (`docs.bundles`). They share a basename by design-doc convention
+ * (cross-repo-docs-plan.md) but never the same path — this reader is built so a
+ * token can never be read from, or written into, the committed repo file:
+ * it only ever touches the `docs` key, and is never routed through
+ * `writeConfigToken`/the home-config writers.
+ *
+ * Kept free of citty/console so it unit-tests directly against a temp dir.
+ */
+/** Repo-relative path of the docs subscription config. */
+export declare const REPO_CONFIG_RELATIVE_PATH = ".auden/config.json";
+/** Absolute path of a repo's `.auden/config.json`, rooted at `cwd`. */
+export declare function repoConfigPath(cwd: string): string;
+/**
+ * True when `cwd`'s repo config path resolves to the *same file* as the
+ * machine-level `~/.auden/config.json` token store — i.e. `cwd` is the home
+ * directory. Reading/writing there would treat the token file as a repo config
+ * and (on write) strip the bearer token, breaking future authenticated
+ * commands. Callers must refuse the repo-config path in that case.
+ */
+export declare function collidesWithHomeConfig(cwd: string): boolean;
+export type RepoDocsConfigResult = {
+    /** Subscribed bundle slugs (trimmed, de-duplicated, empties dropped). */
+    bundles: string[];
+    /** True when the file did not exist on disk. */
+    missing: boolean;
+    /** True when the file existed but was not a JSON object. */
+    malformed: boolean;
+    /** True when a stray top-level `token` key is present (must be stripped on write). */
+    hasToken: boolean;
+};
+/**
+ * Normalize an arbitrary value into a clean list of bundle slugs: keep strings
+ * only, trim each, drop empties, de-duplicate while preserving first-seen
+ * order. Shared by the reader and the merge/write path so a hand-edited config
+ * and a `--bundle` flag are cleaned identically.
+ */
+export declare function normalizeBundleSlugs(value: unknown): string[];
+/**
+ * Read a repo's docs-bundle subscription. Returns an empty list on a missing or
+ * malformed config so callers can treat "not subscribed" uniformly; `missing`
+ * / `malformed` distinguish the two for messaging.
+ */
+export declare function readRepoDocsConfig(cwd: string): Promise<RepoDocsConfigResult>;
+export type WriteRepoDocsResult = {
+    /**
+     * True when a `token` key was found in the existing file and stripped before
+     * writing. The committed repo config must never carry a bearer token; if one
+     * was there (e.g. the file was copied from `~/.auden/config.json` — the exact
+     * basename-collision this slice guards against), we remove it rather than
+     * re-serialize it back into a file the user commits. The caller should warn
+     * so the user can rotate a token that may already be in git history.
+     */
+    removedToken: boolean;
+};
+/**
+ * Persist a repo's docs-bundle subscription, preserving every other key already
+ * in the file (a future `project` identity field, hand-added keys) — but never a
+ * `token`, which is stripped defensively so this committed file can't leak a
+ * credential. Refuses to overwrite a file that exists but is malformed, rather
+ * than silently discarding it.
+ */
+export declare function writeRepoDocsBundles(cwd: string, bundles: string[]): Promise<WriteRepoDocsResult>;
+/**
+ * Union an existing subscription with newly-selected slugs, cleaned and
+ * de-duplicated. `docs enable` is additive: re-running it to add one bundle
+ * must never drop the others already subscribed.
+ */
+export declare function mergeBundleSubscriptions(existing: string[], added: string[]): string[];
+//# sourceMappingURL=repo-config.d.ts.map

package/dist/docs/repo-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-config.d.ts","sourceRoot":"","sources":["../../src/docs/repo-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,uBAAuB,CAAA;AAE7D,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAA;IAClB,sFAAsF;IACtF,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAY7D;AA+BD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAanF;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC;;;;;;;OAOG;IACH,YAAY,EAAE,OAAO,CAAA;CACtB,CAAA;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,mBAAmB,CAAC,CA+B9B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEtF"}

package/dist/docs/repo-config.js

@@ -0,0 +1,143 @@
+/**
+ * Repo-level docs subscription config: `<repo>/.auden/config.json`.
+ *
+ * This is a DIFFERENT file from the machine-level `~/.auden/config.json` that
+ * `src/config.ts` owns. That one lives in the home directory, is chmod `0600`,
+ * and holds the bearer **token**. This one is repo-relative, meant to be
+ * committed to git, and holds only a repo's doc-bundle subscription
+ * (`docs.bundles`). They share a basename by design-doc convention
+ * (cross-repo-docs-plan.md) but never the same path — this reader is built so a
+ * token can never be read from, or written into, the committed repo file:
+ * it only ever touches the `docs` key, and is never routed through
+ * `writeConfigToken`/the home-config writers.
+ *
+ * Kept free of citty/console so it unit-tests directly against a temp dir.
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { AUDEN_CONFIG } from '../auden-paths.js';
+/** Repo-relative path of the docs subscription config. */
+export const REPO_CONFIG_RELATIVE_PATH = '.auden/config.json';
+/** Absolute path of a repo's `.auden/config.json`, rooted at `cwd`. */
+export function repoConfigPath(cwd) {
+    return join(cwd, REPO_CONFIG_RELATIVE_PATH);
+}
+/**
+ * True when `cwd`'s repo config path resolves to the *same file* as the
+ * machine-level `~/.auden/config.json` token store — i.e. `cwd` is the home
+ * directory. Reading/writing there would treat the token file as a repo config
+ * and (on write) strip the bearer token, breaking future authenticated
+ * commands. Callers must refuse the repo-config path in that case.
+ */
+export function collidesWithHomeConfig(cwd) {
+    return resolve(repoConfigPath(cwd)) === resolve(AUDEN_CONFIG);
+}
+/**
+ * Normalize an arbitrary value into a clean list of bundle slugs: keep strings
+ * only, trim each, drop empties, de-duplicate while preserving first-seen
+ * order. Shared by the reader and the merge/write path so a hand-edited config
+ * and a `--bundle` flag are cleaned identically.
+ */
+export function normalizeBundleSlugs(value) {
+    if (!Array.isArray(value))
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const entry of value) {
+        if (typeof entry !== 'string')
+            continue;
+        const slug = entry.trim();
+        if (slug === '' || seen.has(slug))
+            continue;
+        seen.add(slug);
+        out.push(slug);
+    }
+    return out;
+}
+async function readParsedRepoConfig(cwd) {
+    let raw;
+    try {
+        raw = await readFile(repoConfigPath(cwd), 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return { parsed: {}, missing: true, malformed: false };
+        }
+        // Other read errors (permissions, etc.) — treat as malformed so a writer
+        // is forced to handle it explicitly rather than clobbering the file.
+        return { parsed: {}, missing: false, malformed: true };
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return {
+                parsed: parsed,
+                missing: false,
+                malformed: false,
+            };
+        }
+        return { parsed: {}, missing: false, malformed: true };
+    }
+    catch {
+        return { parsed: {}, missing: false, malformed: true };
+    }
+}
+/**
+ * Read a repo's docs-bundle subscription. Returns an empty list on a missing or
+ * malformed config so callers can treat "not subscribed" uniformly; `missing`
+ * / `malformed` distinguish the two for messaging.
+ */
+export async function readRepoDocsConfig(cwd) {
+    // In the home directory the "repo config" path IS the token store — never
+    // read it as a subscription config (see collidesWithHomeConfig).
+    if (collidesWithHomeConfig(cwd)) {
+        return { bundles: [], missing: true, malformed: false, hasToken: false };
+    }
+    const { parsed, missing, malformed } = await readParsedRepoConfig(cwd);
+    const docs = parsed['docs'];
+    const bundles = docs && typeof docs === 'object' && !Array.isArray(docs)
+        ? normalizeBundleSlugs(docs['bundles'])
+        : [];
+    return { bundles, missing, malformed, hasToken: 'token' in parsed };
+}
+/**
+ * Persist a repo's docs-bundle subscription, preserving every other key already
+ * in the file (a future `project` identity field, hand-added keys) — but never a
+ * `token`, which is stripped defensively so this committed file can't leak a
+ * credential. Refuses to overwrite a file that exists but is malformed, rather
+ * than silently discarding it.
+ */
+export async function writeRepoDocsBundles(cwd, bundles) {
+    // Never write to the home token store (cwd === home) — that would strip the
+    // bearer token and rewrite it as a repo config.
+    if (collidesWithHomeConfig(cwd)) {
+        throw new Error(`Refusing to write a repo docs config at ${repoConfigPath(cwd)} — it is the ` +
+            'home token store (~/.auden/config.json). Run `auden pull` from inside a repository.');
+    }
+    const { parsed, malformed } = await readParsedRepoConfig(cwd);
+    if (malformed) {
+        throw new Error(`Refusing to overwrite malformed repo config at ${repoConfigPath(cwd)}. ` +
+            'Fix or remove the file before re-running.');
+    }
+    // Strip any bearer token before it can be written back into the committed
+    // file — the whole point of a separate repo config is that it never holds one.
+    const removedToken = 'token' in parsed;
+    delete parsed['token'];
+    const existingDocs = parsed['docs'] && typeof parsed['docs'] === 'object' && !Array.isArray(parsed['docs'])
+        ? parsed['docs']
+        : {};
+    parsed['docs'] = { ...existingDocs, bundles: normalizeBundleSlugs(bundles) };
+    const path = repoConfigPath(cwd);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(parsed, null, 2) + '\n');
+    return { removedToken };
+}
+/**
+ * Union an existing subscription with newly-selected slugs, cleaned and
+ * de-duplicated. `docs enable` is additive: re-running it to add one bundle
+ * must never drop the others already subscribed.
+ */
+export function mergeBundleSubscriptions(existing, added) {
+    return normalizeBundleSlugs([...existing, ...added]);
+}
+//# sourceMappingURL=repo-config.js.map

package/dist/docs/repo-config.js.map

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

package/dist/docs/status.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Core logic for `auden docs status`: show which bundles the current repo
+ * subscribes to and whether each has been materialized locally yet. Slice 1a is
+ * pull-only with no per-file sidecar, so "state" is deliberately coarse —
+ * subscribed, and materialized (N files) or not-yet-pulled. The richer
+ * three-point in-sync/ahead/behind state arrives with the link sidecar (Slice 2).
+ *
+ * Kept free of citty/console — the command injects the filesystem read.
+ */
+export type DocsStatusRow = {
+    bundle: string;
+    /** Local directory the bundle materializes into. */
+    dir: string;
+    /** True when that directory exists on disk. */
+    exists: boolean;
+    /** Count of `.md` files present in the directory (0 when missing). */
+    materialized: number;
+};
+export type DocsStatusDeps = {
+    /**
+     * List a directory's entries, or return `null` when it does not exist. Any
+     * other read error should propagate so a genuine fault isn't reported as
+     * "not yet pulled".
+     */
+    listDir: (dir: string) => Promise<string[] | null>;
+};
+/** Build a status row per subscribed bundle. */
+export declare function computeDocsStatus(cwd: string, bundles: string[], deps: DocsStatusDeps): Promise<DocsStatusRow[]>;
+/**
+ * Render the status as plain lines. Returns a guidance message when the repo
+ * has no subscription yet, so the command prints something actionable either
+ * way.
+ */
+export declare function formatDocsStatus(rows: DocsStatusRow[]): string;
+//# sourceMappingURL=status.d.ts.map

package/dist/docs/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/docs/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAA;IACf,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;OAIG;IACH,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;CACnD,CAAA;AAED,gDAAgD;AAChD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,MAAM,CAY9D"}

package/dist/docs/status.js

@@ -0,0 +1,48 @@
+/**
+ * Core logic for `auden docs status`: show which bundles the current repo
+ * subscribes to and whether each has been materialized locally yet. Slice 1a is
+ * pull-only with no per-file sidecar, so "state" is deliberately coarse —
+ * subscribed, and materialized (N files) or not-yet-pulled. The richer
+ * three-point in-sync/ahead/behind state arrives with the link sidecar (Slice 2).
+ *
+ * Kept free of citty/console — the command injects the filesystem read.
+ */
+import { defaultPullDir } from '../context/pull.js';
+/** Build a status row per subscribed bundle. */
+export async function computeDocsStatus(cwd, bundles, deps) {
+    const rows = [];
+    for (const bundle of bundles) {
+        const dir = defaultPullDir(bundle, cwd);
+        const entries = await deps.listDir(dir);
+        rows.push({
+            bundle,
+            dir,
+            exists: entries !== null,
+            // Case-insensitive: writeItemsToDir preserves a name that already ends in
+            // .MD/.Md (its own extension check is case-insensitive), so those count too.
+            materialized: entries
+                ? entries.filter((e) => e.toLowerCase().endsWith('.md')).length
+                : 0,
+        });
+    }
+    return rows;
+}
+/**
+ * Render the status as plain lines. Returns a guidance message when the repo
+ * has no subscription yet, so the command prints something actionable either
+ * way.
+ */
+export function formatDocsStatus(rows) {
+    if (rows.length === 0) {
+        return 'This repo is not subscribed to any doc bundles. Run `auden pull <bundle>` to subscribe.';
+    }
+    const lines = ['Subscribed doc bundles:'];
+    for (const row of rows) {
+        const state = row.exists
+            ? `${row.materialized} file(s) in ${row.dir}`
+            : 'not yet pulled — run `auden sync`';
+        lines.push(`  ${row.bundle} — ${state}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=status.js.map

package/dist/docs/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/docs/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAqBnD,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAW,EACX,OAAiB,EACjB,IAAoB;IAEpB,MAAM,IAAI,GAAoB,EAAE,CAAA;IAChC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACvC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,CAAC,IAAI,CAAC;YACR,MAAM;YACN,GAAG;YACH,MAAM,EAAE,OAAO,KAAK,IAAI;YACxB,0EAA0E;YAC1E,6EAA6E;YAC7E,YAAY,EAAE,OAAO;gBACnB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;gBAC/D,CAAC,CAAC,CAAC;SACN,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAqB;IACpD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,yFAAyF,CAAA;IAClG,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,yBAAyB,CAAC,CAAA;IACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM;YACtB,CAAC,CAAC,GAAG,GAAG,CAAC,YAAY,eAAe,GAAG,CAAC,GAAG,EAAE;YAC7C,CAAC,CAAC,mCAAmC,CAAA;QACvC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,MAAM,KAAK,EAAE,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/docs/subscribe.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Subscription helpers shared by `auden pull` (subscribe-on-pull) and any other
+ * caller that records a repo's doc-bundle subscription. The subscription itself
+ * is just `docs.bundles` in the repo `.auden/config.json` (see repo-config.ts);
+ * `auden sync`'s docs phase reads it and keeps those bundles fresh.
+ *
+ * Kept free of citty/console so it unit-tests directly against a temp dir.
+ */
+export type BundleChoice = {
+    slug: string;
+    name: string;
+};
+/**
+ * Parse an interactive selection line into slugs. Tokens are split on commas
+ * and whitespace; a token that is a 1-based index into `choices` resolves to
+ * that bundle's slug, anything else is treated as a literal slug. De-duplicated,
+ * order preserved.
+ */
+export declare function parseSelectionInput(input: string, choices: BundleChoice[]): string[];
+export type SubscribeResult = {
+    ok: true;
+    /** Full resulting subscription (existing ∪ added). */
+    subscribed: string[];
+    /** Slugs newly added this call (not already subscribed). */
+    added: string[];
+    /** True when a stray `token` key was stripped from the repo config on write. */
+    removedToken: boolean;
+} | {
+    ok: false;
+    reason: 'malformed-config' | 'home-collision' | 'write-failed';
+    message?: string;
+};
+/**
+ * Record a repo's subscription to `bundles`, additively — existing
+ * subscriptions are never dropped. Writes when the set actually grows, or when a
+ * stray `token` must be stripped from the committed config; otherwise the file
+ * is left byte-for-byte untouched (no spurious git diff). Never throws — every
+ * failure becomes an `ok:false` reason so the caller can warn without aborting
+ * the surrounding command (a pull still succeeds even if the subscription can't
+ * be recorded):
+ *   - `malformed-config` — the config exists but isn't valid JSON.
+ *   - `home-collision` — `cwd` is the home dir, where the repo config would be
+ *     the token store; we refuse rather than clobber the bearer token.
+ *   - `write-failed` — a filesystem error (read-only repo, race, etc.).
+ */
+export declare function subscribeBundles(cwd: string, bundles: string[]): Promise<SubscribeResult>;
+//# sourceMappingURL=subscribe.d.ts.map

package/dist/docs/subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.d.ts","sourceRoot":"","sources":["../../src/docs/subscribe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAsBpF;AAED,MAAM,MAAM,eAAe,GACvB;IACE,EAAE,EAAE,IAAI,CAAA;IACR,sDAAsD;IACtD,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,gFAAgF;IAChF,YAAY,EAAE,OAAO,CAAA;CACtB,GACD;IACE,EAAE,EAAE,KAAK,CAAA;IACT,MAAM,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,cAAc,CAAA;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAEL;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,eAAe,CAAC,CA2B1B"}

package/dist/docs/subscribe.js

@@ -0,0 +1,83 @@
+/**
+ * Subscription helpers shared by `auden pull` (subscribe-on-pull) and any other
+ * caller that records a repo's doc-bundle subscription. The subscription itself
+ * is just `docs.bundles` in the repo `.auden/config.json` (see repo-config.ts);
+ * `auden sync`'s docs phase reads it and keeps those bundles fresh.
+ *
+ * Kept free of citty/console so it unit-tests directly against a temp dir.
+ */
+import { collidesWithHomeConfig, mergeBundleSubscriptions, readRepoDocsConfig, writeRepoDocsBundles, } from './repo-config.js';
+/**
+ * Parse an interactive selection line into slugs. Tokens are split on commas
+ * and whitespace; a token that is a 1-based index into `choices` resolves to
+ * that bundle's slug, anything else is treated as a literal slug. De-duplicated,
+ * order preserved.
+ */
+export function parseSelectionInput(input, choices) {
+    const slugs = new Set(choices.map((c) => c.slug));
+    const seen = new Set();
+    const out = [];
+    for (const token of input.split(/[\s,]+/)) {
+        const t = token.trim();
+        if (t === '')
+            continue;
+        let slug = t;
+        // Exact slug match wins over index parsing, so a numeric-only slug (e.g. a
+        // bundle literally named "2026") selects that bundle instead of being read
+        // as the 2026th choice.
+        if (!slugs.has(t) && /^\d+$/.test(t)) {
+            const idx = Number.parseInt(t, 10) - 1;
+            if (idx < 0 || idx >= choices.length)
+                continue; // out-of-range number: ignore
+            slug = choices[idx].slug;
+        }
+        if (!seen.has(slug)) {
+            seen.add(slug);
+            out.push(slug);
+        }
+    }
+    return out;
+}
+/**
+ * Record a repo's subscription to `bundles`, additively — existing
+ * subscriptions are never dropped. Writes when the set actually grows, or when a
+ * stray `token` must be stripped from the committed config; otherwise the file
+ * is left byte-for-byte untouched (no spurious git diff). Never throws — every
+ * failure becomes an `ok:false` reason so the caller can warn without aborting
+ * the surrounding command (a pull still succeeds even if the subscription can't
+ * be recorded):
+ *   - `malformed-config` — the config exists but isn't valid JSON.
+ *   - `home-collision` — `cwd` is the home dir, where the repo config would be
+ *     the token store; we refuse rather than clobber the bearer token.
+ *   - `write-failed` — a filesystem error (read-only repo, race, etc.).
+ */
+export async function subscribeBundles(cwd, bundles) {
+    if (collidesWithHomeConfig(cwd)) {
+        return { ok: false, reason: 'home-collision' };
+    }
+    const existing = await readRepoDocsConfig(cwd);
+    if (existing.malformed) {
+        return { ok: false, reason: 'malformed-config' };
+    }
+    const existingSet = new Set(existing.bundles);
+    const added = bundles.filter((slug) => !existingSet.has(slug));
+    const subscribed = mergeBundleSubscriptions(existing.bundles, bundles);
+    // Skip the write only when nothing changed AND there's no stray token to
+    // strip — otherwise a token copied into an already-subscribed repo config
+    // would never be removed (writeRepoDocsBundles is the only path that strips it).
+    if (added.length === 0 && !existing.hasToken) {
+        return { ok: true, subscribed, added, removedToken: false };
+    }
+    try {
+        const { removedToken } = await writeRepoDocsBundles(cwd, subscribed);
+        return { ok: true, subscribed, added, removedToken };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: 'write-failed',
+            message: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+//# sourceMappingURL=subscribe.js.map

package/dist/docs/subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../src/docs/subscribe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,kBAAkB,CAAA;AAIzB;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,OAAuB;IACxE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QACtB,IAAI,CAAC,KAAK,EAAE;YAAE,SAAQ;QACtB,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,2EAA2E;QAC3E,2EAA2E;QAC3E,wBAAwB;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;YACtC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM;gBAAE,SAAQ,CAAC,8BAA8B;YAC7E,IAAI,GAAG,OAAO,CAAC,GAAG,CAAE,CAAC,IAAI,CAAA;QAC3B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAkBD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,OAAiB;IAEjB,IAAI,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;IAChD,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAA;IAC9C,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAA;IAClD,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9D,MAAM,UAAU,GAAG,wBAAwB,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACtE,yEAAyE;IACzE,0EAA0E;IAC1E,iFAAiF;IACjF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAA;IAC7D,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QACpE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAAA;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,cAAc;YACtB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SAC1D,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/docs/sync-docs.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The docs phase of `auden sync`: for each bundle a repo subscribes to, pull
+ * its canonical items into `.auden/context/<bundle>/` and keep them fresh.
+ * Pull-only (Slice 1a) — this is the "repos stay fresh" heartbeat; local edits
+ * pushing back is a later slice.
+ *
+ * Reuses the shipped `pullBundleToDir`/`defaultPullDir` (the `auden pull`
+ * engine) so a subscribed sync and a manual `auden pull` write identically.
+ * Each bundle is pulled independently: one bundle's failure is captured and
+ * reported, never aborting the others — mirroring the per-batch resilience of
+ * the push loop and the guide-bundle pull's own try/catch.
+ *
+ * Kept free of citty/console so it unit-tests against a mocked client.
+ */
+import type { ContextClient } from '../mcp/client.js';
+import type { WriteItemsDeps } from '../mcp/write-items.js';
+/**
+ * Server-side maximum items a single pull returns (`MAX_LIMIT` in the items
+ * endpoint). Without an explicit limit the endpoint defaults to 100, so a
+ * subscribed bundle with more than 100 docs would silently materialize only the
+ * newest 100. Request the max, and flag when a bundle hits the ceiling — the
+ * endpoint has no cursor pagination, so beyond this we surface the truncation
+ * rather than pretend the bundle is fully synced (no silent caps).
+ */
+export declare const MAX_BUNDLE_PULL = 500;
+export type DocsSyncBundleResult = {
+    bundle: string;
+    /** Directory the bundle materialized into. */
+    dir: string;
+    /** Number of items the bundle returned (including skipped null-content ones). */
+    items: number;
+    /** Number of files actually written to disk. */
+    written: number;
+    /** True when the bundle returned the server cap — more docs may exist unpulled. */
+    truncated: boolean;
+    /** Present when this bundle failed to pull; the others still ran. */
+    error?: string;
+};
+export type DocsSyncResult = {
+    results: DocsSyncBundleResult[];
+    /** True when at least one bundle failed to pull. */
+    hadError: boolean;
+};
+/**
+ * Pull every subscribed bundle into its default local directory under `cwd`.
+ * `deps` injects the filesystem for tests.
+ */
+export declare function syncSubscribedDocs(client: ContextClient, bundles: string[], cwd: string, deps?: WriteItemsDeps): Promise<DocsSyncResult>;
+/**
+ * One legible line per bundle for the sync output (Planning Principle 9 — what
+ * moved is never ambiguous). Failures read as warnings; a successful pull says
+ * how many files landed where.
+ */
+export declare function formatDocsSyncLine(result: DocsSyncBundleResult): string;
+//# sourceMappingURL=sync-docs.d.ts.map

package/dist/docs/sync-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-docs.d.ts","sourceRoot":"","sources":["../../src/docs/sync-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAA;IACX,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAA;IACf,mFAAmF;IACnF,SAAS,EAAE,OAAO,CAAA;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,oBAAoB,EAAE,CAAA;IAC/B,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EAAE,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAWvE"}

package/dist/docs/sync-docs.js

@@ -0,0 +1,72 @@
+/**
+ * The docs phase of `auden sync`: for each bundle a repo subscribes to, pull
+ * its canonical items into `.auden/context/<bundle>/` and keep them fresh.
+ * Pull-only (Slice 1a) — this is the "repos stay fresh" heartbeat; local edits
+ * pushing back is a later slice.
+ *
+ * Reuses the shipped `pullBundleToDir`/`defaultPullDir` (the `auden pull`
+ * engine) so a subscribed sync and a manual `auden pull` write identically.
+ * Each bundle is pulled independently: one bundle's failure is captured and
+ * reported, never aborting the others — mirroring the per-batch resilience of
+ * the push loop and the guide-bundle pull's own try/catch.
+ *
+ * Kept free of citty/console so it unit-tests against a mocked client.
+ */
+import { defaultPullDir, pullBundleToDir } from '../context/pull.js';
+/**
+ * Server-side maximum items a single pull returns (`MAX_LIMIT` in the items
+ * endpoint). Without an explicit limit the endpoint defaults to 100, so a
+ * subscribed bundle with more than 100 docs would silently materialize only the
+ * newest 100. Request the max, and flag when a bundle hits the ceiling — the
+ * endpoint has no cursor pagination, so beyond this we surface the truncation
+ * rather than pretend the bundle is fully synced (no silent caps).
+ */
+export const MAX_BUNDLE_PULL = 500;
+/**
+ * Pull every subscribed bundle into its default local directory under `cwd`.
+ * `deps` injects the filesystem for tests.
+ */
+export async function syncSubscribedDocs(client, bundles, cwd, deps = {}) {
+    const results = [];
+    for (const bundle of bundles) {
+        const dir = defaultPullDir(bundle, cwd);
+        try {
+            const { items, written } = await pullBundleToDir(client, { bundle, limit: MAX_BUNDLE_PULL }, dir, deps);
+            results.push({
+                bundle,
+                dir,
+                items: items.length,
+                written: written.length,
+                truncated: items.length >= MAX_BUNDLE_PULL,
+            });
+        }
+        catch (err) {
+            results.push({
+                bundle,
+                dir,
+                items: 0,
+                written: 0,
+                truncated: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return { results, hadError: results.some((r) => r.error !== undefined) };
+}
+/**
+ * One legible line per bundle for the sync output (Planning Principle 9 — what
+ * moved is never ambiguous). Failures read as warnings; a successful pull says
+ * how many files landed where.
+ */
+export function formatDocsSyncLine(result) {
+    if (result.error) {
+        return `  warning: docs "${result.bundle}" — ${result.error} — skipping.`;
+    }
+    const skipped = result.items - result.written;
+    const skippedNote = skipped > 0 ? ` (${skipped} item(s) without text content skipped, e.g. assets)` : '';
+    const truncatedNote = result.truncated
+        ? ` — note: hit the ${MAX_BUNDLE_PULL}-item limit, older docs may be unpulled`
+        : '';
+    return `  pulled ${result.written} doc(s) from "${result.bundle}" → ${result.dir}${skippedNote}${truncatedNote}`;
+}
+//# sourceMappingURL=sync-docs.js.map

package/dist/docs/sync-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-docs.js","sourceRoot":"","sources":["../../src/docs/sync-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAKpE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAA;AAsBlC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAqB,EACrB,OAAiB,EACjB,GAAW,EACX,OAAuB,EAAE;IAEzB,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACvC,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,eAAe,CAC9C,MAAM,EACN,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,EAClC,GAAG,EACH,IAAI,CACL,CAAA;YACD,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,GAAG;gBACH,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,OAAO,EAAE,OAAO,CAAC,MAAM;gBACvB,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,eAAe;aAC3C,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,GAAG;gBACH,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,CAAC;gBACV,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,CAAA;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA4B;IAC7D,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,oBAAoB,MAAM,CAAC,MAAM,OAAO,MAAM,CAAC,KAAK,cAAc,CAAA;IAC3E,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAA;IAC7C,MAAM,WAAW,GACf,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,qDAAqD,CAAC,CAAC,CAAC,EAAE,CAAA;IACtF,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS;QACpC,CAAC,CAAC,oBAAoB,eAAe,yCAAyC;QAC9E,CAAC,CAAC,EAAE,CAAA;IACN,OAAO,YAAY,MAAM,CAAC,OAAO,iBAAiB,MAAM,CAAC,MAAM,OAAO,MAAM,CAAC,GAAG,GAAG,WAAW,GAAG,aAAa,EAAE,CAAA;AAClH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auden",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.5",
   "private": false,
   "description": "Local-first CLI for Auden — evaluates AI coding agent actions against your guides on-device and syncs verdicts to your dashboard.",
   "license": "MIT",
@@ -55,9 +55,9 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@auden.to/eval-core": "0.1.0-alpha.4",
-    "@auden.to/projections": "0.1.0-alpha.4",
-    "@auden.to/protocol": "0.1.0-alpha.4",
+    "@auden.to/eval-core": "0.1.0-alpha.5",
+    "@auden.to/projections": "0.1.0-alpha.5",
+    "@auden.to/protocol": "0.1.0-alpha.5",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "citty": "^0.1.6",
     "diff": "^9.0.0"