@north-light/crouter 0.3.318 → 0.3.320

package/dist/commands/sys/sync-project-guidance.js

@@ -1,481 +1,4 @@
-// `crtr sys sync project-guidance` — one-way migration of a repository's
-// CLAUDE.md/AGENTS.md/.claude/rules into repository-root and nested
-// `.crouter/memory/` stores. Only the repository root owns the namespace and
-// workspace front door; nested stores derive their prefix from their path.
-import { envProfileId } from '../../shared/env.js';
-import { existsSync, readdirSync, statSync } from 'node:fs';
-import { basename, join, resolve } from 'node:path';
-import { defineLeaf } from '../../core/command.js';
-import { parseFrontmatterGeneric } from '../../core/frontmatter.js';
-import { usage } from '../../core/errors.js';
-import { pathExists, readText, realpathOrSelf, walkFiles, writeText } from '../../core/fs-utils.js';
-import { loadProfileManifest } from '../../core/profiles/manifest.js';
-import { CRTR_DIR_NAME } from '../../types.js';
-import { memoryFilePath, serializeMemoryDoc } from '../memory/shared.js';
-import { normalizedName, routeFromDescription, scalarString } from './sync-shared.js';
-import { deriveProjectNamespace } from '../../core/memory/project-namespace.js';
-import { associateRepository } from '../../core/memory/repository-association.js';
-import { openProjectMemoryStore } from '../../core/memory-resolver.js';
-import { composeCanonicalName, localNameFromPath, resolveLocalName, validateExplicitLocalName, } from '../../core/memory/identity.js';
-// Directories a project-doc walk never descends into — build/dependency trees
-// plus crouter's own state dir.
-const PROJECT_DOC_JUNK_DIRS = new Set([
-    'node_modules', '.git', '.venv', 'venv', 'dist', 'build', '.next', '.cache', '.yalc', '.sisyphus', CRTR_DIR_NAME,
-]);
-// First-match-per-dir order mirrors pi's own loader (AGENTS.md wins over CLAUDE.md).
-const PROJECT_DOC_FILENAMES = ['AGENTS.md', 'CLAUDE.md'];
-/** Discovery roots for the project-doc walk: an explicit `--source` pins a
- *  single dir; otherwise cwd plus (when a profile is selected) every project
- *  in its purview — the same profile-widened idea `findProjectScopeRoots`
- *  applies to the boot render, so one invocation can migrate a whole
- *  workspace instead of one repo at a time. Deduped, cwd first; never throws
- *  on a missing/unreadable profile (cwd-only fallback). */
-function projectDocRoots(sourceArg) {
-    if (sourceArg !== undefined)
-        return [resolve(sourceArg)];
-    const roots = [resolve(process.cwd())];
-    const profileId = envProfileId();
-    if (profileId !== undefined && profileId !== '') {
-        try {
-            const { manifest } = loadProfileManifest(profileId);
-            for (const p of manifest.projects) {
-                const r = resolve(p.path);
-                if (!roots.includes(r))
-                    roots.push(r);
-            }
-        }
-        catch {
-            // No/unreadable profile — cwd-only root.
-        }
-    }
-    return roots;
-}
-/** Walk `root` (skipping PROJECT_DOC_JUNK_DIRS) collecting every dir's
- *  CLAUDE.md/AGENTS.md (first match per dir) plus every `.claude/rules/*.md`.
- *  Each result names the directory whose OWN `.crouter/memory/` it targets. */
-function collectProjectDocCandidates(root) {
-    const out = [];
-    if (!existsSync(root) || !statSync(root).isDirectory())
-        return out;
-    const rootResolved = resolve(root);
-    const stack = [rootResolved];
-    while (stack.length > 0) {
-        const dir = stack.pop();
-        for (const name of PROJECT_DOC_FILENAMES) {
-            const p = join(dir, name);
-            if (existsSync(p) && statSync(p).isFile()) {
-                out.push({ kind: 'agents', path: p, sourceDir: dir, walkRoot: rootResolved });
-                break;
-            }
-        }
-        const rulesDir = join(dir, '.claude', 'rules');
-        if (existsSync(rulesDir)) {
-            for (const file of walkFiles(rulesDir, (n) => n.endsWith('.md'))) {
-                out.push({ kind: 'rule', path: file, sourceDir: dir, walkRoot: rootResolved });
-            }
-        }
-        let entries;
-        try {
-            entries = readdirSync(dir, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const e of entries) {
-            if (e.isDirectory() && !PROJECT_DOC_JUNK_DIRS.has(e.name))
-                stack.push(join(dir, e.name));
-        }
-    }
-    return out;
-}
-/** First non-empty line, heading markers stripped, truncated — the `short-form`
- *  gist synthesized from a body with no frontmatter description to draw from. */
-function synthesizeShortForm(body) {
-    for (const raw of body.split('\n')) {
-        const cleaned = raw.replace(/^#+\s*/, '').replace(/\s+/g, ' ').trim();
-        if (cleaned !== '')
-            return cleaned.length > 200 ? `${cleaned.slice(0, 197)}...` : cleaned;
-    }
-    return 'Migrated project guidance.';
-}
-/** `.claude/rules` frontmatter `paths:` normalizes to a glob list — a single
- *  string, an array, or absent for a workspace-wide rule. */
-/** Split a rule's comma-separated `paths` string into globs, honoring brace
- *  groups — `"lib/**\/*.{ts,tsx}, proxy.ts"` is two globs, and the comma inside
- *  `{ts,tsx}` never splits. Authored rules use both the comma-joined string and
- *  the YAML-list shape. */
-function splitTopLevelCommas(s) {
-    const out = [];
-    let depth = 0;
-    let cur = '';
-    for (const ch of s) {
-        if (ch === '{')
-            depth += 1;
-        else if (ch === '}')
-            depth = Math.max(0, depth - 1);
-        if (ch === ',' && depth === 0) {
-            out.push(cur);
-            cur = '';
-            continue;
-        }
-        cur += ch;
-    }
-    out.push(cur);
-    return out.map((g) => g.trim()).filter((g) => g !== '');
-}
-function normalizeRulePaths(v) {
-    if (typeof v === 'string')
-        return splitTopLevelCommas(v);
-    if (Array.isArray(v)) {
-        return v
-            .filter((g) => typeof g === 'string')
-            .flatMap(splitTopLevelCommas);
-    }
-    return [];
-}
-/** Resolve one effective guidance namespace for a repository. The cache is
- *  keyed by repository root so cwd/profile widening and nested source guides
- *  cannot derive competing identities during one sync. */
-function resolveRepositoryNamespace(sourceDir, walkRoot, rootBodies, memo) {
-    const associated = associateRepository(sourceDir);
-    let repositoryRoot;
-    if (associated.ok) {
-        repositoryRoot = associated.association.repositoryRoot;
-    }
-    else if (associated.ok === false && associated.code === 'no-project-root') {
-        // A guidance walk may initialize a repository that has no memory store yet.
-        repositoryRoot = realpathOrSelf(walkRoot);
-    }
-    else {
-        const reason = associated.ok === false ? associated.reason : 'unknown repository association failure';
-        throw usage(`cannot associate project guidance at ${sourceDir}: ${reason}`, {
-            next: `Run \`crtr sys migrate --dir ${sourceDir}\`.`,
-        });
-    }
-    repositoryRoot = realpathOrSelf(repositoryRoot);
-    const existing = memo.get(repositoryRoot);
-    if (existing !== undefined)
-        return existing;
-    const store = openProjectMemoryStore(repositoryRoot);
-    if (store.mountStatus === 'ready') {
-        const namespace = store.repositoryNamespace ?? store.namespace;
-        const resolved = { namespace, repositoryRoot, initialize: false };
-        memo.set(repositoryRoot, resolved);
-        return resolved;
-    }
-    const memoryDir = join(repositoryRoot, CRTR_DIR_NAME, 'memory');
-    const docs = pathExists(memoryDir) ? walkFiles(memoryDir, (name) => name.endsWith('.md')) : [];
-    if (docs.length > 0) {
-        throw usage(`project memory store at ${memoryDir} is undeclared or invalid`, {
-            next: `Run \`crtr sys migrate --dir ${repositoryRoot}\`.`,
-        });
-    }
-    const derived = deriveProjectNamespace({ ownerDir: repositoryRoot, rootBody: rootBodies.get(repositoryRoot) });
-    if (derived.ok === false) {
-        throw usage(`cannot initialize project memory store at ${memoryDir}: ${derived.reason}`, {
-            next: `Run \`crtr sys migrate --dir ${repositoryRoot}\`.`,
-        });
-    }
-    const resolved = { namespace: derived.namespace, repositoryRoot, initialize: true };
-    memo.set(repositoryRoot, resolved);
-    return resolved;
-}
-/** The surfaces pair every workspace front door carries: whole-doc delivery
- *  when cwd/profile mounts the store, plus on any file read beneath the
- *  store's owning dir. */
-function frontDoorSurfaces() {
-    return [
-        { on: 'workspace-open', at: 'content' },
-        { on: 'read', match: './**', at: 'content' },
-    ];
-}
-/** `./`-anchor a rule glob that could only match repo-relatively: any glob
- *  containing `/` that starts with neither `/`, `**`, nor `./`. Mirrors the
- *  surfaces migration's anchoring rule — this leaf MINTS new read globs, so it
- *  must anchor them the same way or the routes it writes silently never fire. */
-function anchorReadGlob(g) {
-    const t = g.trim();
-    if (!t.includes('/'))
-        return t;
-    if (t.startsWith('/') || t.startsWith('**') || t.startsWith('./'))
-        return t;
-    return `./${t}`;
-}
-/** AGENTS.md/CLAUDE.md becomes a repository-root or nested store root
- * document. Only the repository root carries the declaration and front door. */
-function prepareAgentsCandidate(candidate, resolution) {
-    const parsed = parseFrontmatterGeneric(readText(candidate.path));
-    const root = realpathOrSelf(candidate.sourceDir) === resolution.repositoryRoot;
-    return prepareRootCandidate(candidate, resolution.namespace, parsed.body, root, parsed.data ?? {});
-}
-function sourceReadRoute(frontmatter) {
-    if (!Array.isArray(frontmatter['surfaces']))
-        return [];
-    return frontmatter['surfaces'].filter((entry) => {
-        if (entry === null || typeof entry !== 'object' || Array.isArray(entry))
-            return false;
-        const value = entry;
-        if (value['on'] !== 'read' || !['name', 'preview', 'content'].includes(String(value['at'])))
-            return false;
-        const match = value['match'];
-        const hasMatch = typeof match === 'string'
-            ? match.trim() !== ''
-            : Array.isArray(match) && match.length > 0 && match.every((glob) => typeof glob === 'string' && glob.trim() !== '');
-        const matchFrontmatter = value['match-frontmatter'];
-        return hasMatch || (matchFrontmatter !== null && typeof matchFrontmatter === 'object' && !Array.isArray(matchFrontmatter));
-    });
-}
-function prepareRootCandidate(candidate, namespace, body, repositoryRoot, sourceFrontmatter = {}) {
-    if (!repositoryRoot) {
-        const surfaces = sourceReadRoute(sourceFrontmatter);
-        const authoredRoute = scalarString(sourceFrontmatter['when-and-why-to-read'])?.trim();
-        const frontmatter = {
-            kind: 'knowledge',
-            'when-and-why-to-read': authoredRoute !== undefined && authoredRoute !== ''
-                ? authoredRoute
-                : `When working under ${namespace}, this knowledge should be read because it carries the nested project guidance.`,
-            'short-form': synthesizeShortForm(body),
-            ...(surfaces.length > 0 ? { surfaces } : {}),
-        };
-        return {
-            candidate,
-            name: '',
-            target: join(candidate.sourceDir, CRTR_DIR_NAME, 'memory', 'INDEX.md'),
-            frontmatter,
-            body,
-        };
-    }
-    const frontmatter = {
-        kind: 'knowledge',
-        namespace,
-        'when-and-why-to-read': `When working in ${namespace}, this knowledge should be read because it is the project's operating guide.`,
-        'short-form': synthesizeShortForm(body),
-        surfaces: frontDoorSurfaces(),
-    };
-    return {
-        candidate,
-        name: namespace,
-        target: join(candidate.sourceDir, CRTR_DIR_NAME, 'memory', 'INDEX.md'),
-        frontmatter,
-        body,
-    };
-}
-/** A rule's identity is store-local. The physical path supplies the default;
- *  an authored name is accepted as an explicit local identity. */
-function prepareRuleCandidate(candidate, resolution) {
-    const associated = associateRepository(candidate.sourceDir);
-    if (!associated.ok) {
-        throw usage(`cannot associate rule guidance at ${candidate.path}: ${associated.reason}`, {
-            next: `Run \`crtr sys migrate --dir ${candidate.sourceDir}\`.`,
-        });
-    }
-    // Nested stores inherit the repository declaration plus their normalized
-    // owner-relative path, exactly as the runtime's project store descriptor.
-    const namespace = composeCanonicalName(resolution.namespace, associated.association.ownerRelativePath);
-    const raw = readText(candidate.path);
-    const parsed = parseFrontmatterGeneric(raw);
-    const fm = parsed.data ?? {};
-    const physicalLeaf = normalizedName(basename(candidate.path));
-    const pathLocal = localNameFromPath(`${physicalLeaf}.md`);
-    const localName = resolveLocalName(fm, pathLocal);
-    const valid = validateExplicitLocalName(localName, namespace);
-    if (valid.ok === false)
-        throw usage(`invalid local rule name in ${candidate.path}: ${valid.reason}`);
-    const description = scalarString(fm['description']) ?? '';
-    const name = composeCanonicalName(namespace, localName);
-    const frontmatter = {
-        kind: 'knowledge',
-        name: localName,
-        'when-and-why-to-read': description !== ''
-            ? routeFromDescription(description, 'knowledge')
-            : `When working under ${namespace}, this knowledge should be read because it is migrated project rule guidance.`,
-        'short-form': description !== '' ? description.replace(/\s+/g, ' ').trim() : synthesizeShortForm(parsed.body),
-    };
-    const globs = normalizeRulePaths(fm['paths']).map(anchorReadGlob);
-    // A pathless rule is still readable, but it must not mint a repository
-    // workspace front door; that belongs exclusively to the repository root.
-    frontmatter['surfaces'] = globs.length > 0
-        ? [{ on: 'read', match: globs.length === 1 ? globs[0] : globs, at: 'content' }]
-        : [{ on: 'read', match: './**', at: 'content' }];
-    return {
-        candidate,
-        name,
-        target: memoryFilePath(join(candidate.sourceDir, CRTR_DIR_NAME, 'memory'), localName),
-        frontmatter,
-        body: parsed.body,
-    };
-}
-/** Write (or dry-run report) a prepared project doc — copy-not-move,
- *  skip-existing unless `--overwrite`. */
-function convertProjectDoc(prepared, opts) {
-    if (pathExists(prepared.target) && !opts.overwrite) {
-        return {
-            source: prepared.candidate.path,
-            target: prepared.target,
-            name: prepared.name,
-            scope: 'project',
-            status: 'skipped',
-            reason: 'target memory doc already exists; re-run with --overwrite to replace it',
-        };
-    }
-    if (!opts.dryRun)
-        writeText(prepared.target, serializeMemoryDoc(prepared.frontmatter, prepared.body));
-    return {
-        source: prepared.candidate.path,
-        target: prepared.target,
-        name: prepared.name,
-        scope: 'project',
-        status: opts.dryRun ? 'would-import' : 'imported',
-    };
-}
-function validateAuthoredNamespace(candidate, resolution) {
-    if (candidate.kind !== 'agents')
-        return;
-    let requested;
-    try {
-        requested = parseFrontmatterGeneric(readText(candidate.path)).data?.['namespace'];
-    }
-    catch {
-        return;
-    }
-    if (requested === undefined)
-        return;
-    const root = realpathOrSelf(candidate.sourceDir) === resolution.repositoryRoot;
-    const declarationPath = join(resolution.repositoryRoot, CRTR_DIR_NAME, 'memory', 'INDEX.md');
-    if (!root) {
-        throw usage(`project guidance at ${candidate.path} declares a namespace, but ${declarationPath} is the only declaration for this repository`, { next: `Run \`crtr sys migrate --dir ${resolution.repositoryRoot}\`.` });
-    }
-    if (requested !== resolution.namespace) {
-        throw usage(`project guidance namespace ${JSON.stringify(requested)} conflicts with the declared store namespace ${JSON.stringify(resolution.namespace)}`, {
-            next: `Run \`crtr sys migrate --dir ${resolution.repositoryRoot}\` for a repository-wide identity change.`,
-        });
-    }
-}
-function renderSummary(results) {
-    const imported = results.filter((r) => r.status === 'imported').length;
-    const wouldImport = results.filter((r) => r.status === 'would-import').length;
-    const skipped = results.filter((r) => r.status === 'skipped').length;
-    const header = wouldImport > 0
-        ? `crtr sys sync project-guidance — dry run: ${wouldImport} would import, ${skipped} skipped`
-        : `crtr sys sync project-guidance — ${imported} imported, ${skipped} skipped`;
-    const rows = results.map((r) => {
-        const reason = r.reason ? ` (${r.reason})` : '';
-        return `| ${r.status} | ${r.scope}/${r.name || '—'} | ${r.target} | ${r.source}${reason} |`;
-    });
-    const body = rows.length === 0
-        ? ['No sync candidates.']
-        : ['| status | memory doc | target | source |', '| --- | --- | --- | --- |', ...rows];
-    return [header, '', ...body].join('\n');
-}
-export const sysSyncProjectGuidanceLeaf = defineLeaf({
-    name: 'project-guidance',
-    description: 'migrate repository guidance into repository-root and nested crouter memory docs',
-    whenToUse: "migrating repository CLAUDE.md/AGENTS.md/.claude/rules into the crouter memory-doc model: one-way copy into the repository root's or nested store's .crouter/memory/. Only the repository-root guide becomes the workspace front door; nested guides and rules keep read routes. Never exports memory docs back to these source files.",
-    help: {
-        name: 'sys sync project-guidance',
-        summary: 'one-way migration: CLAUDE.md/AGENTS.md/.claude/rules → repository-root and nested crouter memory docs',
-        params: [
-            { kind: 'flag', name: 'source', type: 'string', required: false, constraint: "The root to walk recursively for CLAUDE.md/AGENTS.md/.claude/rules files. Default: cwd plus every project in the current profile's purview (when one is selected)." },
-            { kind: 'flag', name: 'dry-run', type: 'bool', required: false, constraint: 'Show what would be migrated without writing memory docs.' },
-            { kind: 'flag', name: 'overwrite', type: 'bool', required: false, constraint: 'Replace an existing target memory doc. Default: skip existing docs to avoid clobbering user-authored memory.' },
-        ],
-        output: [
-            { name: 'results', type: 'object[]', required: true, constraint: 'Each: {source,target,name,scope,status,reason?}; status is one of imported, skipped, would-import.' },
-        ],
-        outputKind: 'object',
-        effects: [
-            "Copies the repository-root CLAUDE.md/AGENTS.md into the repository-root .crouter/memory/INDEX.md with the namespace declaration and workspace front-door surfaces. Copies nested guides into nested .crouter/memory/INDEX.md files without namespace, name, or workspace-open metadata. Copies each .claude/rules/*.md into its nested store with a local name and a content read entry over the source paths (‘./’-anchored when repo-relative), or a plain read route when no paths are declared. Originals are left untouched.",
-            'Skips existing memory docs unless --overwrite is present.',
-            'With --dry-run: read-only; writes nothing.',
-        ],
-    },
-    run: async (input) => {
-        const sourceArg = input['source'];
-        const dryRun = input['dryRun'] ?? false;
-        const overwrite = input['overwrite'] ?? false;
-        const results = [];
-        const docSeen = new Set();
-        const candidates = [];
-        for (const root of projectDocRoots(sourceArg)) {
-            for (const c of collectProjectDocCandidates(root)) {
-                if (docSeen.has(c.path))
-                    continue;
-                docSeen.add(c.path);
-                candidates.push(c);
-            }
-        }
-        // Resolve each repository once. Root guide bodies are collected before
-        // resolution so derivation does not depend on discovery order.
-        const rootBodies = new Map();
-        for (const c of candidates) {
-            if (c.kind !== 'agents')
-                continue;
-            try {
-                rootBodies.set(realpathOrSelf(c.sourceDir), parseFrontmatterGeneric(readText(c.path)).body);
-            }
-            catch {
-                rootBodies.set(realpathOrSelf(c.sourceDir), undefined);
-            }
-        }
-        const resolutions = new Map();
-        const candidateResolutions = new Map();
-        for (const c of candidates) {
-            const resolution = resolveRepositoryNamespace(c.sourceDir, c.walkRoot, rootBodies, resolutions);
-            candidateResolutions.set(c.path, resolution);
-            validateAuthoredNamespace(c, resolution);
-        }
-        const preparedEntries = [];
-        for (const c of candidates) {
-            const resolution = candidateResolutions.get(c.path);
-            // Isolate one malformed source file (e.g. invalid YAML in a rule's
-            // frontmatter) as its own skipped row — it must never abort the whole
-            // migration.
-            try {
-                const prepared = c.kind === 'agents'
-                    ? prepareAgentsCandidate(c, resolution)
-                    : prepareRuleCandidate(c, resolution);
-                preparedEntries.push({ candidate: c, prepared });
-            }
-            catch (e) {
-                const msg = (e instanceof Error ? e.message : String(e)).split('\n')[0];
-                results.push({
-                    source: c.path,
-                    target: '',
-                    name: '',
-                    scope: 'project',
-                    status: 'skipped',
-                    reason: `unparseable source frontmatter: ${msg} — fix the source file and re-run`,
-                });
-            }
-        }
-        // A rules-only source still needs one repository-root declaration for the
-        // store to mount. Nested rule directories never receive synthetic roots.
-        for (const resolution of resolutions.values()) {
-            const hasRootGuide = candidates.some((c) => c.kind === 'agents' && candidateResolutions.get(c.path)?.repositoryRoot === resolution.repositoryRoot && realpathOrSelf(c.sourceDir) === resolution.repositoryRoot);
-            if (hasRootGuide || openProjectMemoryStore(resolution.repositoryRoot).mountStatus === 'ready')
-                continue;
-            const first = candidates.find((c) => candidateResolutions.get(c.path)?.repositoryRoot === resolution.repositoryRoot);
-            if (first === undefined)
-                continue;
-            const syntheticCandidate = {
-                ...first,
-                kind: 'agents',
-                sourceDir: resolution.repositoryRoot,
-            };
-            const root = prepareRootCandidate(syntheticCandidate, resolution.namespace, 'Migrated project guidance.', true);
-            results.push(convertProjectDoc(root, { dryRun, overwrite }));
-        }
-        // Repository roots are always emitted before nested stores, so a real run
-        // mounts the repository before any nested content is written.
-        const ordered = [...preparedEntries].sort((a, b) => {
-            const ar = realpathOrSelf(a.candidate.sourceDir) === candidateResolutions.get(a.candidate.path).repositoryRoot;
-            const br = realpathOrSelf(b.candidate.sourceDir) === candidateResolutions.get(b.candidate.path).repositoryRoot;
-            return Number(br) - Number(ar);
-        });
-        for (const { prepared } of ordered) {
-            results.push(convertProjectDoc(prepared, { dryRun, overwrite }));
-        }
-        return { results };
-    },
-    render: (result) => renderSummary(result.results),
-});
+var F=Object.defineProperty;var p=(e,t)=>F(e,"name",{value:t,configurable:!0});import{envProfileId as O}from"../../shared/env.js";import{existsSync as b,readdirSync as W,statSync as S}from"node:fs";import{basename as _,join as g,resolve as $}from"node:path";import{defineLeaf as z}from"../../core/command.js";import{parseFrontmatterGeneric as v}from"../../core/frontmatter.js";import{usage as w}from"../../core/errors.js";import{pathExists as E,readText as j,realpathOrSelf as y,walkFiles as A,writeText as U}from"../../core/fs-utils.js";import{loadProfileManifest as q}from"../../core/profiles/manifest.js";import{CRTR_DIR_NAME as k}from"../../types.js";import{memoryFilePath as J,serializeMemoryDoc as X}from"../memory/shared.js";import{normalizedName as B,routeFromDescription as K,scalarString as x}from"./sync-shared.js";import{deriveProjectNamespace as H}from"../../core/memory/project-namespace.js";import{associateRepository as C}from"../../core/memory/repository-association.js";import{openProjectMemoryStore as P}from"../../core/memory-resolver.js";import{composeCanonicalName as T,localNameFromPath as Q,resolveLocalName as V,validateExplicitLocalName as Y}from"../../core/memory/identity.js";const Z=new Set(["node_modules",".git",".venv","venv","dist","build",".next",".cache",".yalc",".sisyphus",k]),ee=["AGENTS.md","CLAUDE.md"];function te(e){if(e!==void 0)return[$(e)];const t=[$(process.cwd())],o=O();if(o!==void 0&&o!=="")try{const{manifest:a}=q(o);for(const r of a.projects){const n=$(r.path);t.includes(n)||t.push(n)}}catch{}return t}p(te,"projectDocRoots");function oe(e){const t=[];if(!b(e)||!S(e).isDirectory())return t;const o=$(e),a=[o];for(;a.length>0;){const r=a.pop();for(const i of ee){const d=g(r,i);if(b(d)&&S(d).isFile()){t.push({kind:"agents",path:d,sourceDir:r,walkRoot:o});break}}const n=g(r,".claude","rules");if(b(n))for(const i of A(n,d=>d.endsWith(".md")))t.push({kind:"rule",path:i,sourceDir:r,walkRoot:o});let c;try{c=W(r,{withFileTypes:!0})}catch{continue}for(const i of c)i.isDirectory()&&!Z.has(i.name)&&a.push(g(r,i.name))}return t}p(oe,"collectProjectDocCandidates");function N(e){for(const t of e.split(`
+`)){const o=t.replace(/^#+\s*/,"").replace(/\s+/g," ").trim();if(o!=="")return o.length>200?`${o.slice(0,197)}...`:o}return"Migrated project guidance."}p(N,"synthesizeShortForm");function L(e){const t=[];let o=0,a="";for(const r of e){if(r==="{"?o+=1:r==="}"&&(o=Math.max(0,o-1)),r===","&&o===0){t.push(a),a="";continue}a+=r}return t.push(a),t.map(r=>r.trim()).filter(r=>r!=="")}p(L,"splitTopLevelCommas");function re(e){return typeof e=="string"?L(e):Array.isArray(e)?e.filter(t=>typeof t=="string").flatMap(L):[]}p(re,"normalizeRulePaths");function ne(e,t,o,a){const r=C(e);let n;if(r.ok)n=r.association.repositoryRoot;else if(r.ok===!1&&r.code==="no-project-root")n=y(t);else{const s=r.ok===!1?r.reason:"unknown repository association failure";throw w(`cannot associate project guidance at ${e}: ${s}`,{next:`Run \`crtr sys migrate --dir ${e}\`.`})}n=y(n);const c=a.get(n);if(c!==void 0)return c;const i=P(n);if(i.mountStatus==="ready"){const u={namespace:i.repositoryNamespace??i.namespace,repositoryRoot:n,initialize:!1};return a.set(n,u),u}const d=g(n,k,"memory");if((E(d)?A(d,s=>s.endsWith(".md")):[]).length>0)throw w(`project memory store at ${d} is undeclared or invalid`,{next:`Run \`crtr sys migrate --dir ${n}\`.`});const f=H({ownerDir:n,rootBody:o.get(n)});if(f.ok===!1)throw w(`cannot initialize project memory store at ${d}: ${f.reason}`,{next:`Run \`crtr sys migrate --dir ${n}\`.`});const h={namespace:f.namespace,repositoryRoot:n,initialize:!0};return a.set(n,h),h}p(ne,"resolveRepositoryNamespace");function se(){return[{on:"workspace-open",at:"content"},{on:"read",match:"./**",at:"content"}]}p(se,"frontDoorSurfaces");function ae(e){const t=e.trim();return!t.includes("/")||t.startsWith("/")||t.startsWith("**")||t.startsWith("./")?t:`./${t}`}p(ae,"anchorReadGlob");function ie(e,t){const o=v(j(e.path)),a=y(e.sourceDir)===t.repositoryRoot;return M(e,t.namespace,o.body,a,o.data??{})}p(ie,"prepareAgentsCandidate");function ce(e){return Array.isArray(e.surfaces)?e.surfaces.filter(t=>{if(t===null||typeof t!="object"||Array.isArray(t))return!1;const o=t;if(o.on!=="read"||!["name","preview","content"].includes(String(o.at)))return!1;const a=o.match,r=typeof a=="string"?a.trim()!=="":Array.isArray(a)&&a.length>0&&a.every(c=>typeof c=="string"&&c.trim()!==""),n=o["match-frontmatter"];return r||n!==null&&typeof n=="object"&&!Array.isArray(n)}):[]}p(ce,"sourceReadRoute");function M(e,t,o,a,r={}){if(!a){const c=ce(r),i=x(r["when-and-why-to-read"])?.trim(),d={kind:"knowledge","when-and-why-to-read":i!==void 0&&i!==""?i:`When working under ${t}, this knowledge should be read because it carries the nested project guidance.`,"short-form":N(o),...c.length>0?{surfaces:c}:{}};return{candidate:e,name:"",target:g(e.sourceDir,k,"memory","INDEX.md"),frontmatter:d,body:o}}const n={kind:"knowledge",namespace:t,"when-and-why-to-read":`When working in ${t}, this knowledge should be read because it is the project's operating guide.`,"short-form":N(o),surfaces:se()};return{candidate:e,name:t,target:g(e.sourceDir,k,"memory","INDEX.md"),frontmatter:n,body:o}}p(M,"prepareRootCandidate");function de(e,t){const o=C(e.sourceDir);if(!o.ok)throw w(`cannot associate rule guidance at ${e.path}: ${o.reason}`,{next:`Run \`crtr sys migrate --dir ${e.sourceDir}\`.`});const a=T(t.namespace,o.association.ownerRelativePath),r=j(e.path),n=v(r),c=n.data??{},i=B(_(e.path)),d=Q(`${i}.md`),l=V(c,d),f=Y(l,a);if(f.ok===!1)throw w(`invalid local rule name in ${e.path}: ${f.reason}`);const h=x(c.description)??"",s=T(a,l),u={kind:"knowledge",name:l,"when-and-why-to-read":h!==""?K(h,"knowledge"):`When working under ${a}, this knowledge should be read because it is migrated project rule guidance.`,"short-form":h!==""?h.replace(/\s+/g," ").trim():N(n.body)},m=re(c.paths).map(ae);return u.surfaces=m.length>0?[{on:"read",match:m.length===1?m[0]:m,at:"content"}]:[{on:"read",match:"./**",at:"content"}],{candidate:e,name:s,target:J(g(e.sourceDir,k,"memory"),l),frontmatter:u,body:n.body}}p(de,"prepareRuleCandidate");function I(e,t){return E(e.target)&&!t.overwrite?{source:e.candidate.path,target:e.target,name:e.name,scope:"project",status:"skipped",reason:"target memory doc already exists; re-run with --overwrite to replace it"}:(t.dryRun||U(e.target,X(e.frontmatter,e.body)),{source:e.candidate.path,target:e.target,name:e.name,scope:"project",status:t.dryRun?"would-import":"imported"})}p(I,"convertProjectDoc");function ue(e,t){if(e.kind!=="agents")return;let o;try{o=v(j(e.path)).data?.namespace}catch{return}if(o===void 0)return;const a=y(e.sourceDir)===t.repositoryRoot,r=g(t.repositoryRoot,k,"memory","INDEX.md");if(!a)throw w(`project guidance at ${e.path} declares a namespace, but ${r} is the only declaration for this repository`,{next:`Run \`crtr sys migrate --dir ${t.repositoryRoot}\`.`});if(o!==t.namespace)throw w(`project guidance namespace ${JSON.stringify(o)} conflicts with the declared store namespace ${JSON.stringify(t.namespace)}`,{next:`Run \`crtr sys migrate --dir ${t.repositoryRoot}\` for a repository-wide identity change.`})}p(ue,"validateAuthoredNamespace");function pe(e){const t=e.filter(i=>i.status==="imported").length,o=e.filter(i=>i.status==="would-import").length,a=e.filter(i=>i.status==="skipped").length,r=o>0?`crtr sys sync project-guidance \u2014 dry run: ${o} would import, ${a} skipped`:`crtr sys sync project-guidance \u2014 ${t} imported, ${a} skipped`,n=e.map(i=>{const d=i.reason?` (${i.reason})`:"";return`| ${i.status} | ${i.scope}/${i.name||"\u2014"} | ${i.target} | ${i.source}${d} |`}),c=n.length===0?["No sync candidates."]:["| status | memory doc | target | source |","| --- | --- | --- | --- |",...n];return[r,"",...c].join(`
+`)}p(pe,"renderSummary");const Ee=z({name:"project-guidance",description:"migrate repository guidance into repository-root and nested crouter memory docs",whenToUse:"migrating repository CLAUDE.md/AGENTS.md/.claude/rules into the crouter memory-doc model: one-way copy into the repository root's or nested store's .crouter/memory/. Only the repository-root guide becomes the workspace front door; nested guides and rules keep read routes. Never exports memory docs back to these source files.",help:{name:"sys sync project-guidance",summary:"one-way migration: CLAUDE.md/AGENTS.md/.claude/rules \u2192 repository-root and nested crouter memory docs",params:[{kind:"flag",name:"source",type:"string",required:!1,constraint:"The root to walk recursively for CLAUDE.md/AGENTS.md/.claude/rules files. Default: cwd plus every project in the current profile's purview (when one is selected)."},{kind:"flag",name:"dry-run",type:"bool",required:!1,constraint:"Show what would be migrated without writing memory docs."},{kind:"flag",name:"overwrite",type:"bool",required:!1,constraint:"Replace an existing target memory doc. Default: skip existing docs to avoid clobbering user-authored memory."}],output:[{name:"results",type:"object[]",required:!0,constraint:"Each: {source,target,name,scope,status,reason?}; status is one of imported, skipped, would-import."}],outputKind:"object",effects:["Copies the repository-root CLAUDE.md/AGENTS.md into the repository-root .crouter/memory/INDEX.md with the namespace declaration and workspace front-door surfaces. Copies nested guides into nested .crouter/memory/INDEX.md files without namespace, name, or workspace-open metadata. Copies each .claude/rules/*.md into its nested store with a local name and a content read entry over the source paths (\u2018./\u2019-anchored when repo-relative), or a plain read route when no paths are declared. Originals are left untouched.","Skips existing memory docs unless --overwrite is present.","With --dry-run: read-only; writes nothing."]},run:p(async e=>{const t=e.source,o=e.dryRun??!1,a=e.overwrite??!1,r=[],n=new Set,c=[];for(const s of te(t))for(const u of oe(s))n.has(u.path)||(n.add(u.path),c.push(u));const i=new Map;for(const s of c)if(s.kind==="agents")try{i.set(y(s.sourceDir),v(j(s.path)).body)}catch{i.set(y(s.sourceDir),void 0)}const d=new Map,l=new Map;for(const s of c){const u=ne(s.sourceDir,s.walkRoot,i,d);l.set(s.path,u),ue(s,u)}const f=[];for(const s of c){const u=l.get(s.path);try{const m=s.kind==="agents"?ie(s,u):de(s,u);f.push({candidate:s,prepared:m})}catch(m){const R=(m instanceof Error?m.message:String(m)).split(`
+`)[0];r.push({source:s.path,target:"",name:"",scope:"project",status:"skipped",reason:`unparseable source frontmatter: ${R} \u2014 fix the source file and re-run`})}}for(const s of d.values()){if(c.some(D=>D.kind==="agents"&&l.get(D.path)?.repositoryRoot===s.repositoryRoot&&y(D.sourceDir)===s.repositoryRoot)||P(s.repositoryRoot).mountStatus==="ready")continue;const m=c.find(D=>l.get(D.path)?.repositoryRoot===s.repositoryRoot);if(m===void 0)continue;const R={...m,kind:"agents",sourceDir:s.repositoryRoot},G=M(R,s.namespace,"Migrated project guidance.",!0);r.push(I(G,{dryRun:o,overwrite:a}))}const h=[...f].sort((s,u)=>{const m=y(s.candidate.sourceDir)===l.get(s.candidate.path).repositoryRoot,R=y(u.candidate.sourceDir)===l.get(u.candidate.path).repositoryRoot;return Number(R)-Number(m)});for(const{prepared:s}of h)r.push(I(s,{dryRun:o,overwrite:a}));return{results:r}},"run"),render:p(e=>pe(e.results),"render")});export{Ee as sysSyncProjectGuidanceLeaf};

package/dist/commands/sys/sync-shared.js

@@ -1,49 +1 @@
-// sync-shared.ts — pure helpers shared by all three `crtr sys sync` leaves
-// (skills, project-guidance, deps): frontmatter scalar coercion, routing-prose
-// synthesis, and memory-doc name normalization. No other dependencies, so this
-// module has no import direction to police.
-export function scalarString(value) {
-    if (typeof value === 'string')
-        return value;
-    if (typeof value === 'number' || typeof value === 'boolean')
-        return String(value);
-    return undefined;
-}
-function cleanClause(s) {
-    let out = s.replace(/\s+/g, ' ').trim();
-    out = out.replace(/^[,;:.\s]+/, '').replace(/[,;:.\s]+$/, '');
-    if (/^[A-Z][a-z]/.test(out))
-        out = out.charAt(0).toLowerCase() + out.slice(1);
-    return out;
-}
-const USE_WHEN_RE = /\b(?:use\s+this\s+skill\s+when|use\s+this\s+when|this\s+skill\s+should\s+be\s+used\s+when|used\s+when|use\s+when)\b\s*/i;
-export function routeFromDescription(description, kind) {
-    const desc = description.replace(/\s+/g, ' ').trim();
-    if (desc === '')
-        return `When this migrated ${kind} applies, this ${kind} should be read.`;
-    const m = desc.match(USE_WHEN_RE);
-    if (m && m.index !== undefined) {
-        const gist = cleanClause(desc.slice(0, m.index));
-        const situation = cleanClause(desc.slice(m.index + m[0].length));
-        if (situation !== '') {
-            let out = `When ${situation}, this ${kind} should be read`;
-            if (gist !== '')
-                out += ` because ${gist}`;
-            return `${out}.`;
-        }
-    }
-    return `When ${cleanClause(desc)}, this ${kind} should be read.`;
-}
-/** Slugify a raw name/path segment into a memory-doc-safe identity: lowercase,
- *  `.md` stripped, path separators normalized to `/`, each segment reduced to
- *  `[a-z0-9._-]`. Shared by the skills lane (bundle names) and the
- *  project-guidance lane (project/subdir labels). */
-export function normalizedName(raw) {
-    const segments = raw
-        .replace(/\\/g, '/')
-        .replace(/\.md$/i, '')
-        .split('/')
-        .map((s) => s.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, ''))
-        .filter(Boolean);
-    return segments.join('/');
-}
+var a=Object.defineProperty;var r=(s,e)=>a(s,"name",{value:e,configurable:!0});function p(s){if(typeof s=="string")return s;if(typeof s=="number"||typeof s=="boolean")return String(s)}r(p,"scalarString");function i(s){let e=s.replace(/\s+/g," ").trim();return e=e.replace(/^[,;:.\s]+/,"").replace(/[,;:.\s]+$/,""),/^[A-Z][a-z]/.test(e)&&(e=e.charAt(0).toLowerCase()+e.slice(1)),e}r(i,"cleanClause");const u=/\b(?:use\s+this\s+skill\s+when|use\s+this\s+when|this\s+skill\s+should\s+be\s+used\s+when|used\s+when|use\s+when)\b\s*/i;function d(s,e){const t=s.replace(/\s+/g," ").trim();if(t==="")return`When this migrated ${e} applies, this ${e} should be read.`;const n=t.match(u);if(n&&n.index!==void 0){const o=i(t.slice(0,n.index)),c=i(t.slice(n.index+n[0].length));if(c!==""){let l=`When ${c}, this ${e} should be read`;return o!==""&&(l+=` because ${o}`),`${l}.`}}return`When ${i(t)}, this ${e} should be read.`}r(d,"routeFromDescription");function f(s){return s.replace(/\\/g,"/").replace(/\.md$/i,"").split("/").map(t=>t.trim().toLowerCase().replace(/[^a-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")).filter(Boolean).join("/")}r(f,"normalizedName");export{f as normalizedName,d as routeFromDescription,p as scalarString};