@leji-org/leji 1.0.0

package/dist/commands/init.js

@@ -0,0 +1,378 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as readline from 'node:readline';
+import { execFileSync } from 'node:child_process';
+import { templatesDir } from '../lib/schemas.js';
+import { writeIndex } from './indexgen.js';
+function gitConfig(key) {
+    try {
+        const out = execFileSync('git', ['config', '--get', key], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return out || null;
+    }
+    catch {
+        return null;
+    }
+}
+function defaultAnswers(dir, options) {
+    const base = path
+        .basename(path.resolve(dir))
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        // The line above collapses each run of non-alphanumerics to a single '-',
+        // so dashes are never consecutive — trimming one per end is sufficient and
+        // avoids the polynomial-backtracking `-+$` (js/polynomial-redos).
+        .replace(/^-|-$/g, '');
+    return {
+        name: options.name ?? `${base}-context`,
+        description: 'Shared context layer for this repository.',
+        rootPath: 'docs/',
+        ownerName: gitConfig('user.name') ?? '<named owner>',
+        ownerContact: gitConfig('user.email') ?? '',
+        categories: ['domain', 'system', 'decisions'],
+        level: options.level ?? 'core',
+    };
+}
+/**
+ * Queued line reader: unlike readline/promises' question(), lines arriving
+ * while no question is pending (piped stdin delivers everything at once) are
+ * buffered instead of dropped.
+ */
+const EOF = Symbol('eof');
+class LineReader {
+    lines = [];
+    waiters = [];
+    closed = false;
+    rl;
+    constructor() {
+        this.rl = readline.createInterface({ input: process.stdin });
+        this.rl.on('line', (line) => {
+            const waiter = this.waiters.shift();
+            if (waiter)
+                waiter(line);
+            else
+                this.lines.push(line);
+        });
+        this.rl.on('close', () => {
+            this.closed = true;
+            for (const waiter of this.waiters.splice(0))
+                waiter(EOF);
+        });
+    }
+    /** Next input line, or EOF when stdin closed (Ctrl-D) with nothing buffered. */
+    next() {
+        if (this.lines.length > 0)
+            return Promise.resolve(this.lines.shift());
+        if (this.closed)
+            return Promise.resolve(EOF);
+        return new Promise((resolve) => this.waiters.push(resolve));
+    }
+    close() {
+        this.rl.close();
+    }
+}
+async function prompt(options) {
+    const defaults = defaultAnswers(options.dir, options);
+    if (options.yes)
+        return defaults;
+    const reader = new LineReader();
+    const readLine = async () => {
+        const a = await reader.next();
+        if (a === EOF) {
+            throw new Error('init aborted: end of input before all questions were answered');
+        }
+        return a;
+    };
+    const ask = async (q, fallback) => {
+        process.stdout.write(fallback ? `${q} (${fallback}): ` : `${q}: `);
+        const a = (await readLine()).trim();
+        return a || fallback;
+    };
+    const askYesNo = async (q, fallback) => {
+        process.stdout.write(`${q} [${fallback ? 'Y/n' : 'y/N'}]: `);
+        const a = (await readLine()).trim().toLowerCase();
+        if (a === '')
+            return fallback;
+        return a === 'y' || a === 'yes';
+    };
+    try {
+        const name = await ask('Layer name', defaults.name);
+        const description = await ask('One-line description', defaults.description);
+        let rootPath = await ask('Context root', defaults.rootPath);
+        if (!rootPath.endsWith('/'))
+            rootPath += '/';
+        const ownerName = await ask('Primary owner (name)', defaults.ownerName);
+        const ownerContact = await ask('Primary owner (contact)', defaults.ownerContact);
+        const categories = [];
+        if (await askYesNo('Map domain (business language, product semantics)?', true))
+            categories.push('domain');
+        if (await askYesNo('Map system (architecture, invariants)?', true))
+            categories.push('system');
+        if (await askYesNo('Map practice (conventions, proven patterns)?', false))
+            categories.push('practice');
+        if (await askYesNo('Map governance (agent guardrails, operating rules)?', false))
+            categories.push('governance');
+        categories.push('decisions');
+        if (!categories.includes('domain') && !categories.includes('system')) {
+            // The spec minimum: at least domain or system, plus decisions.
+            categories.unshift('domain');
+            console.log('At least domain or system is required; mapping domain.');
+        }
+        const indexed = await askYesNo('Generate the machine index and changelog now (indexed level)?', false);
+        return {
+            name,
+            description,
+            rootPath,
+            ownerName,
+            ownerContact,
+            categories,
+            level: indexed ? 'indexed' : 'core',
+        };
+    }
+    finally {
+        reader.close();
+    }
+}
+function readTemplate(name) {
+    return fs.readFileSync(path.join(templatesDir(), name), 'utf8');
+}
+/**
+ * The manifest schema's relative-path rule: rejects absolute paths, `./`
+ * prefixes, any `..` segment, and backslashes. Mirrored here so init refuses
+ * traversal before it writes anything.
+ */
+const RELATIVE_PATH_RE = /^(?!\/)(?!\.\/)(?!.*(^|\/)\.\.(\/|$))(?!.*\\).*$/;
+function assertRelativePath(rel) {
+    if (!RELATIVE_PATH_RE.test(rel)) {
+        throw new Error(`refusing unsafe path "${rel}": must be repository-root-relative (no absolute, .., ./, or \\)`);
+    }
+}
+/** Resolve `rel` under `root` and assert it stays within the resolved root. */
+function safeResolve(rootAbs, rel) {
+    assertRelativePath(rel);
+    const abs = path.resolve(rootAbs, rel);
+    if (abs !== rootAbs && !abs.startsWith(rootAbs + path.sep)) {
+        throw new Error(`refusing to write outside the target directory: "${rel}"`);
+    }
+    return abs;
+}
+function writeFileOnce(rootAbs, rel, content, written) {
+    const abs = safeResolve(rootAbs, rel);
+    if (fs.existsSync(abs))
+        return;
+    fs.mkdirSync(path.dirname(abs), { recursive: true });
+    fs.writeFileSync(abs, content);
+    written.push(rel);
+}
+const CATEGORY_STUBS = {
+    domain: {
+        file: 'glossary.md',
+        title: 'Glossary',
+        summary: 'What the core terms of this product mean, in our own words.',
+        body: '- **<Term>**: <what it means here, including what it does not mean>.\n',
+    },
+    system: {
+        file: 'invariants.md',
+        title: 'System Invariants',
+        summary: 'The constraints every change lives with.',
+        body: '- <An invariant every change must respect, e.g. "money values are integer minor units">.\n',
+    },
+    practice: {
+        file: 'conventions.md',
+        title: 'Conventions',
+        summary: 'Conventions and patterns applied automatically.',
+        body: '- <A convention that has proven out at least twice (the proven-twice gate)>.\n',
+    },
+    governance: {
+        file: 'operating-rules.md',
+        title: 'Operating Rules',
+        summary: 'What agents may do unprompted and what needs a human gate.',
+        body: '- Proceed without asking when: <defaults>.\n- Stop and ask when: <escalation triggers>.\n',
+    },
+};
+function categoryStub(title, summary, body) {
+    return `---\nsummary: ${summary}\n---\n\n# ${title}\n\n${body}`;
+}
+function buildManifest(answers) {
+    const template = JSON.parse(readTemplate('leji.json'));
+    const r = answers.rootPath;
+    const manifest = {
+        $schema: template.$schema,
+        leji: '1.0',
+        name: answers.name,
+        description: answers.description,
+        rootPath: r,
+        bootProfilePath: `${r}boot-profile.md`,
+        categories: {},
+        machine: {
+            agentProfilesPath: `${r}agents/`,
+            decisionRecordsPath: `${r}decisions/`,
+        },
+        owners: {
+            primary: answers.ownerContact
+                ? { name: answers.ownerName, contact: answers.ownerContact }
+                : { name: answers.ownerName },
+        },
+        conformance: {
+            claimedLevel: answers.level,
+            claimedAt: new Date().toISOString().slice(0, 10),
+        },
+    };
+    if (answers.level === 'indexed') {
+        manifest.machine = {
+            indexPath: `${r}context-index.json`,
+            changelogPath: `${r}context-changelog.json`,
+            ...manifest.machine,
+        };
+    }
+    for (const category of answers.categories) {
+        manifest.categories[category] = { paths: [`${r}${category}/`] };
+    }
+    return manifest;
+}
+function buildBootProfile(answers) {
+    let text = readTemplate('boot-profile.md');
+    // The template speaks in docs/ defaults; rewrite for the chosen root.
+    if (answers.rootPath !== 'docs/') {
+        text = text.replaceAll('docs/', answers.rootPath);
+    }
+    text = text.replace('<One paragraph: what this repository/product is, who it serves, what stage it is at.>', answers.description);
+    const r = answers.rootPath;
+    const loadLines = answers.categories
+        .map((c) => {
+        const purpose = {
+            domain: 'what our core terms mean',
+            system: 'architecture and the invariants every change lives with',
+            practice: 'conventions and patterns applied automatically',
+            governance: 'agent guardrails and operating rules',
+            decisions: 'why things are the way they are (check before proposing a reversal)',
+        };
+        return `- \`${r}${c}/\`: ${purpose[c]}`;
+    })
+        .join('\n');
+    text = text.replace(/- `[^`]+domain\/`[^\n]*\n- `[^`]+system\/`[^\n]*\n- `[^`]+decisions\/`[^\n]*/, loadLines);
+    if (answers.level === 'core') {
+        text = text.replace(/\nThe generated map of this layer is `[^`]+`\.\n/, '\n');
+        text = text.replace(/- Append an entry to `[^`]+context-changelog\.json`[^\n]*\n/, '');
+        text = text.replace(/- Regenerate `[^`]+context-index\.json`[^\n]*\n/, '');
+    }
+    return text;
+}
+function buildCoreProfile(answers) {
+    let text = readTemplate(path.join('agents', 'core.md'));
+    if (answers.rootPath !== 'docs/') {
+        text = text.replaceAll('docs/', answers.rootPath);
+    }
+    if (!answers.categories.includes('governance')) {
+        text = text.replace(/^ {2}- .*governance\/\n/m, `  - ${answers.rootPath}decisions/\n`);
+    }
+    return text;
+}
+function buildFirstDecision(answers) {
+    const today = new Date().toISOString().slice(0, 10);
+    const indexedLine = answers.level === 'indexed'
+        ? 'manifest, boot profile, category content, decision records, generated index, machine changelog'
+        : 'manifest, boot profile, category content, decision records';
+    return `---
+id: adopt-leji
+title: Adopt the Leji context layer
+status: accepted
+date: ${today}
+deciders:
+  - ${answers.ownerName}
+---
+
+# Adopt the Leji context layer
+
+## Context
+
+Engineering knowledge lived in heads, chat threads, and per-tool config files. People and agents had no single place to read how this team thinks.
+
+## Decision
+
+Adopt Leji at the \`${answers.level}\` level: ${indexedLine}.
+
+## Consequences
+
+Vendor config files become one-line redirects. Context fixes ride the same review gate as the work that surfaces them. ${answers.ownerName} owns the layer.
+`;
+}
+function buildChangelog(answers, written) {
+    const today = new Date().toISOString().slice(0, 10);
+    const changelog = {
+        $schema: 'https://leji.org/schemas/v1.0/context-changelog.schema.json',
+        schemaVersion: '1.0',
+        entries: [
+            {
+                id: 'seed-layer',
+                date: today,
+                type: 'added',
+                summary: 'Seeded the context layer with leji init.',
+                paths: written,
+                proposedBy: 'leji init',
+                approvedBy: answers.ownerName,
+            },
+        ],
+    };
+    return JSON.stringify(changelog, null, 2) + '\n';
+}
+/**
+ * Bootstrap a context layer from the vendored templates. Interactive unless
+ * --yes. Refuses to run when leji.json already exists; never overwrites
+ * existing files (seeds land only where nothing is in the way).
+ */
+export async function initLayer(options) {
+    const root = path.resolve(options.dir);
+    if (fs.existsSync(path.join(root, 'leji.json'))) {
+        throw new Error('leji.json already exists here; init refuses to overwrite an existing layer');
+    }
+    const answers = await prompt(options);
+    // Guard rootPath (and so every derived write path) before any write: reject
+    // absolute paths, .. segments, ./ prefixes, and backslashes.
+    assertRelativePath(answers.rootPath);
+    const manifest = buildManifest(answers);
+    const written = [];
+    const r = answers.rootPath;
+    // Write leji.json FIRST so the overwrite guard is effective on a retry after
+    // an interrupted run (no orphan half-scaffold the guard can't catch).
+    fs.mkdirSync(root, { recursive: true });
+    fs.writeFileSync(path.join(root, 'leji.json'), JSON.stringify(manifest, null, 2) + '\n');
+    written.push('leji.json');
+    writeFileOnce(root, manifest.bootProfilePath, buildBootProfile(answers), written);
+    for (const category of answers.categories) {
+        if (category === 'decisions')
+            continue;
+        const stub = CATEGORY_STUBS[category];
+        writeFileOnce(root, `${r}${category}/${stub.file}`, categoryStub(stub.title, stub.summary, stub.body), written);
+    }
+    writeFileOnce(root, `${r}decisions/0001-adopt-leji.md`, buildFirstDecision(answers), written);
+    writeFileOnce(root, `${r}agents/core.md`, buildCoreProfile(answers), written);
+    if (answers.level === 'indexed') {
+        writeFileOnce(root, manifest.machine.changelogPath, buildChangelog(answers, [...written]), written);
+    }
+    if (answers.level === 'indexed') {
+        writeIndex(root, manifest);
+        written.push(manifest.machine.indexPath);
+    }
+    return { written: written.sort(), manifest };
+}
+/** Post-init guidance, printed by the CLI. */
+export function enteringTheLayer(manifest) {
+    const boot = manifest.bootProfilePath;
+    return [
+        '',
+        "Enter the layer by direct invocation, so the boot profile is the agent's first context:",
+        '',
+        `   claude "Read ./${boot}, follow all instructions, and tell me when you are ready to begin."`,
+        `   codex "Read ./${boot} and follow it before doing anything else."`,
+        '',
+        'Package the invocation for the whole team (package.json):',
+        '',
+        `   "start": "claude 'Read ./${boot}, follow all instructions, and tell me when you are ready to begin.'"`,
+        '',
+        'Next: fill in the seeded documents, then run `leji validate` and `leji conformance`.',
+    ].join('\n');
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/validate.d.ts

@@ -0,0 +1,25 @@
+import { type Finding } from '../lib/findings.js';
+import { type Manifest } from '../lib/manifest.js';
+/** Vendor entrypoint files checked for the redirect rule even when undeclared. */
+export declare const KNOWN_VENDOR_FILES: string[];
+export interface ValidateResult {
+    findings: Finding[];
+    manifest: Manifest | null;
+}
+export interface ChangelogCheckResult {
+    findings: Finding[];
+    verified: boolean;
+}
+/**
+ * Append-only discipline: every entry present at HEAD must be unchanged and in
+ * the same position; new entries only append. Without a git baseline the
+ * property is unverifiable and reported as a warning (error under --strict).
+ */
+export declare function checkChangelogAppendOnly(root: string, rel: string, strict?: boolean): ChangelogCheckResult;
+/**
+ * Full layer validation: manifest, level-aware artifact requirements, schema
+ * checks, frontmatter contracts, lint rules. Index and changelog are required
+ * from `indexed`; at least one valid agent profile from `governed`. Artifacts
+ * present below their required level are still schema-validated.
+ */
+export declare function validateLayer(root: string): ValidateResult;