@x12i/made-easy 0.0.0-stage → 0.1.0

package/dist/scaffold.js

@@ -0,0 +1,393 @@
+import { stringify } from 'yaml';
+import { CreateGuideRequestSchema, MadeEasyError, SCHEMA_VERSION, getGuideRecipe, } from './contracts/index.js';
+import { normalizeText, sha256Digest, slugify } from './util.js';
+import { memorySource } from './source.js';
+import { readGuide } from './model.js';
+import { BOOK_THEME } from './theme/book.js';
+const todo = (text) => `[[TODO: ${text}]]`;
+const yml = (value) => stringify(value, { lineWidth: 0 }).trimEnd();
+function block(id, type, props) {
+    return `\`\`\`made-easy\n${yml({ id, type, props })}\n\`\`\``;
+}
+/** Stock text plus a TODO guidance paragraph (counts toward the preset's word minimum, blocks release). */
+function prose(c, stock, guidance, expanded) {
+    return `${stock}\n\n${todo(guidance)}${c.handbook ? `\n\n${todo(expanded)}` : ''}`;
+}
+function humanFiles(c) {
+    const s = c.subject;
+    const hb = c.handbook;
+    const opt = (id, kind, label, decidedBy, consequence, evidence) => ({
+        id,
+        kind,
+        label,
+        decidedBy,
+        consequence,
+        evidence,
+    });
+    const files = {};
+    files['human/01-decision.md'] = `# The decision {#decision}
+
+${prose(c, `This guide makes one job easy: **${s}**. One person owns the decision at the end; an operator does the work in between.`, 'State the one concrete job in a sentence a stranger could repeat. Name the question the reader must be able to answer when the job is done, the person who owns that decision, and the specific facts the decision depends on. Keep it to one job: if two jobs appear, split the guide.', 'Add the situations in which this decision is made, the cost of deciding late or wrongly, and what the reader should do when the question cannot be answered yet. Explain the options the owner really has and why each one exists.')}
+
+${block('decision-main', 'decision', {
+        job: todo(`the one concrete job: ${s}`),
+        question: todo('the question this decision answers'),
+        owner: todo('who owns the decision'),
+        dependsOn: [todo('the first fact the decision depends on'), todo('the second fact the decision depends on')],
+        ...(hb
+            ? {
+                options: [
+                    { id: 'proceed', label: todo('proceed on the evidence'), consequence: todo('what changes if the owner proceeds') },
+                    { id: 'hold', label: todo('hold until more is known'), consequence: todo('what the delay costs') },
+                ],
+            }
+            : {}),
+    })}
+`;
+    files['human/02-working-model.md'] = `# How the job works {#working-model}
+
+${prose(c, 'The operator works through a short sequence of stages. Each stage takes inputs, produces outputs, and can fail in a way that changes how you read the result.', 'Describe the inputs, the operator stages in order, the outputs, any side effects, and the points where the job can fail. For each failure point say how the reader should interpret it, not only how to fix it. Keep the diagram and the words consistent with each other.', 'Explain every mechanism that can change the decision: a definition that shifts a number, a sampling rule, a timing effect, a ranking or caching behaviour. For each one say what it changes and how the reader should adjust their judgment when it applies.')}
+
+${block('job-map-main', 'job-map', {
+        inputs: [
+            { id: 'subject-input', label: todo('the first input'), description: todo('where it comes from') },
+            { id: 'scope-input', label: todo('the second input') },
+        ],
+        stages: [
+            { id: 'collect', label: todo('collect'), actor: 'operator', description: todo('what the operator gathers') },
+            { id: 'compare', label: todo('compare'), actor: 'operator', description: todo('what is checked against what') },
+            { id: 'report', label: todo('report back'), actor: 'operator', description: todo('what is returned') },
+        ],
+        outputs: [{ id: 'findings', label: todo('the findings returned to the reader') }],
+        sideEffects: [{ id: 'none', label: todo('state any side effects, or write "none"'), reversible: true }],
+        failurePoints: [
+            {
+                id: 'evidence-gap',
+                stage: 'collect',
+                description: todo('what goes missing or contradicts'),
+                interpretation: todo('how the reader should interpret it'),
+                recovery: todo('what the operator does next'),
+            },
+        ],
+        ...(hb
+            ? {
+                mechanisms: [
+                    {
+                        id: 'definition-shift',
+                        name: todo('a mechanism that changes a decision'),
+                        explanation: todo('how it works'),
+                        decisionImpact: todo('how it changes the reader\u2019s judgment'),
+                    },
+                ],
+            }
+            : {}),
+    })}
+`;
+    files['human/03-ownership.md'] = `# Who does what {#ownership}
+
+${prose(c, 'A human decides; an operator carries out delegated work; and some moments call for a pause so a person can decide before work continues.', 'Assign every human decision, every exact personal step the reader must perform, and every piece of delegated work to a named role. For each pause rule give the trigger, the decision owner, what work may keep going meanwhile, and the condition for resuming.', 'List the exceptions that change who decides: absent owners, conflicting instructions, evidence that arrives late, and requests outside the authorized scope. Say who can authorize each exception and how it is recorded.')}
+
+${block('action-decide', 'human-action', {
+        kind: 'decision',
+        actor: todo('who decides'),
+        action: todo('the decision this person makes'),
+    })}
+
+${block('action-do', 'human-action', {
+        kind: 'action',
+        actor: todo('who performs this step'),
+        action: todo('the exact personal step'),
+        steps: [todo('first step'), todo('second step')],
+    })}
+
+${block('action-delegate', 'human-action', {
+        kind: 'delegated',
+        actor: 'Operator',
+        action: todo('the work delegated to the operator'),
+    })}
+
+${block('pause-stop-on-ambiguity', 'pause', { rule: 'stop-on-ambiguity' })}
+${hb ? `\n${block('exception-absent-owner', 'callout', { variant: 'exception', title: todo('exception'), text: todo('what happens when the decision owner is unavailable') })}\n` : ''}`;
+    files['human/04-operator-brief.md'] = `# The operator brief {#operator-brief}
+
+${prose(c, 'Hand the operator this brief. It states the goal, the inputs, what the operator may read and change, when to stop, how success is checked, and what to return.', 'Check that the brief is complete without this book: goal, inputs with placeholders, authority, limits, pause rules, acceptance checks and the report-back fields. Do not prescribe procedures; leave the choice of method inside the authorized scope to the operator.', 'Explain how to fill the template for a new run, which inputs change between runs, which never do, and how the pinned operator-reference revision is refreshed when the reference changes.')}
+
+${block('brief-main', 'brief', { view: 'both' })}
+`;
+    files['human/05-evidence-review.md'] = `# Reviewing the evidence {#evidence-review}
+
+${prose(c, 'Two results from the same job follow: one you can use and one you should not. Both are checked against the same acceptance checks.', 'Show the usable result and a plausible failure side by side. Name the decisive checks, say what makes a result partial, what makes it invalid, and what the reader does to recover. The failure must look believable: it should be the kind of result you could be tempted to accept.', 'Walk through the failure check by check. Explain why it can look right at first glance, which single observation exposes it, and which neighbouring checks would not have caught it.')}
+
+${block('comparison-main', 'evidence-comparison', {
+        usable: 'result-usable',
+        flawed: 'result-flawed',
+        decisiveChecks: ['check-comparability'],
+        partialWhen: todo('what makes a result partial'),
+        invalidWhen: todo('what makes a result invalid'),
+        recovery: todo('the recovery action'),
+    })}
+
+${block('checklist-main', 'review-checklist', { title: 'Before you accept a result' })}
+`;
+    files['human/06-next-decision.md'] = `# The next decision {#next-decision}
+
+${prose(c, 'With the evidence reviewed, the owner chooses one of a small set of next steps. Each choice names who decides and which evidence supports it.', 'List the choices that apply: accept, request a targeted rerun, authorize a next action, or escalate. For each choice state who decides and cite the checks or results that support it. Leave out choices that do not apply to this job.', 'Describe what each choice sets in motion, what it costs, and how to undo it. Add the conditions under which a rerun is targeted rather than complete.')}
+
+${block('decision-next', 'decision', {
+        question: todo('what should happen next?'),
+        owner: todo('who decides'),
+        options: [
+            opt('accept', 'accept', todo('accept the result'), todo('decision owner'), todo('what accepting means'), ['check:check-primary', 'result:result-usable']),
+            opt('rerun', 'rerun', todo('request a targeted rerun'), todo('decision owner'), todo('what a rerun costs'), ['check:check-comparability', 'result:result-flawed']),
+            opt('authorize', 'authorize', todo('authorize the next action'), todo('decision owner'), todo('what the next action changes'), ['check:check-primary']),
+            opt('escalate', 'escalate', todo('escalate'), todo('who receives the escalation'), todo('what escalation involves'), ['result:result-flawed']),
+        ],
+    })}
+`;
+    return files;
+}
+function profileFields(c) {
+    switch (c.recipe.profile) {
+        case 'market':
+            return {
+                audience: todo('who was measured'),
+                market: todo('which market'),
+                timeframe: todo('the period covered'),
+                method: todo('how it was measured'),
+                sampleFrame: todo('the sample frame'),
+                comparability: todo('the rules that make two results comparable'),
+            };
+        case 'product':
+            return {
+                modelOrRelease: todo('model or release'),
+                platform: todo('platform'),
+                configuration: todo('the configuration to apply'),
+                resultingStateEvidence: todo('the evidence of the resulting state'),
+            };
+        case 'service':
+            return {
+                region: todo('region'),
+                plan: todo('plan'),
+                eligibility: todo('who is eligible'),
+                effectiveTerms: todo('effective terms, where relevant'),
+                confirmationEvidence: todo('the provider confirmation or delivery evidence'),
+            };
+        case 'sdk':
+            return {
+                distribution: 'npm',
+                package: todo('package name'),
+                requested: todo('requested range'),
+                version: todo('exact version resolved from the registry'),
+                integrity: todo('registry integrity (sha512-...)'),
+                registry: 'https://registry.npmjs.org/',
+                runtime: todo('runtime and version'),
+                interface: todo('the interface the job uses'),
+                testEnvironment: todo('the test environment'),
+            };
+    }
+}
+function operatorFiles(c) {
+    const files = {};
+    files['operator/01-scope.md'] = `# Scope and profile {#scope}
+
+Facts the operator must honour for this ${c.recipe.profile} job. ${todo('Replace each placeholder with an exact value.')}
+
+${block('profile-main', 'reference-profile', { profile: c.recipe.profile, fields: profileFields(c) })}
+`;
+    files['operator/02-procedure.md'] = `# Procedure {#procedure}
+
+${todo('Exact commands, procedures and supported versions go here. Keep personal steps for the reader in the human guide.')}
+
+${block('procedure-main', 'code', { language: 'sh', caption: 'Commands', code: '# add the exact commands the operator runs\n' })}
+`;
+    const order = ['scope', 'procedure'];
+    if (c.recipe.profile === 'sdk') {
+        files['operator/03-interface.md'] = `# Interface {#interface}
+
+${todo('API shapes and example output for the interface the job uses.')}
+
+${block('interface-main', 'code', { language: 'ts', caption: 'Interface', code: '// the calls the job makes\n' })}
+`;
+        files['operator/04-example.md'] = `# Runnable example {#example}
+
+A complete example the operator can run, with its expected result.
+
+${block('example-main', 'example', {
+            title: 'Smallest complete run',
+            language: 'js',
+            runtime: 'Node.js 22 or later',
+            fixture: 'operator/fixtures/quickstart',
+            files: ['example.mjs'],
+            run: ['node example.mjs'],
+            expected: 'ok\n',
+            executable: true,
+        })}
+`;
+        files['operator/fixtures/quickstart/example.mjs'] = `console.log('ok');\n`;
+        order.push('interface', 'example');
+    }
+    files['operator/05-recovery.md'] = `# Recovery {#recovery}
+
+${todo('For each failure point in the job map, the exact recovery steps.')}
+`;
+    order.push('recovery');
+    return files;
+}
+/** Scaffold a complete two-track bundle from a recipe, without any model. */
+export function scaffoldGuide(input) {
+    const parsed = CreateGuideRequestSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new MadeEasyError('SCHEMA_INVALID', parsed.error.issues.map((i) => `${i.path.join('.') || 'request'}: ${i.message}`).join('; '));
+    }
+    const req = parsed.data;
+    const recipe = getGuideRecipe(req.recipe);
+    const subject = req.subject.name.trim();
+    const guideId = req.guideId ?? slugify(subject);
+    const jobId = req.jobId ?? `${guideId}-job`;
+    const c = { recipe, subject, handbook: recipe.preset === 'handbook' };
+    const human = humanFiles(c);
+    const operator = operatorFiles(c);
+    const files = { ...human, ...operator };
+    const operatorEntries = [
+        { id: 'scope', role: 'scope', path: 'operator/01-scope.md' },
+        { id: 'procedure', role: 'procedure', path: 'operator/02-procedure.md' },
+        ...(recipe.profile === 'sdk'
+            ? [
+                { id: 'interface', role: 'interface', path: 'operator/03-interface.md' },
+                { id: 'example', role: 'example', path: 'operator/04-example.md' },
+            ]
+            : []),
+        { id: 'recovery', role: 'recovery', path: 'operator/05-recovery.md' },
+    ];
+    files['guide.yaml'] = `${yml({
+        schemaVersion: SCHEMA_VERSION,
+        guideId,
+        jobId,
+        locale: req.locale ?? 'en',
+        subject: {
+            type: recipe.profile,
+            name: subject,
+            ...(req.subject.subtitle ? { subtitle: req.subject.subtitle } : {}),
+            scope: req.subject.scope ?? todo('what this guide covers, and what it does not'),
+        },
+        recipe: { id: recipe.id, version: recipe.version },
+        theme: { id: BOOK_THEME.id, version: BOOK_THEME.version },
+        tracks: {
+            human: [
+                { id: 'decision', role: 'decision', path: 'human/01-decision.md' },
+                { id: 'working-model', role: 'working-model', path: 'human/02-working-model.md' },
+                { id: 'ownership', role: 'ownership', path: 'human/03-ownership.md' },
+                { id: 'operator-brief', role: 'operator-brief', path: 'human/04-operator-brief.md' },
+                { id: 'evidence-review', role: 'evidence-review', path: 'human/05-evidence-review.md' },
+                { id: 'next-decision', role: 'next-decision', path: 'human/06-next-decision.md' },
+            ],
+            operator: operatorEntries,
+        },
+    })}\n`;
+    files['brief.yaml'] = `${yml({
+        schemaVersion: SCHEMA_VERSION,
+        outcome: todo(`the outcome the operator must deliver for: ${subject}`),
+        inputs: [
+            { id: 'subject-input', label: 'Subject input', placeholder: '<subject input>', example: todo('a worked example value'), required: true },
+            { id: 'scope-input', label: 'Scope input', placeholder: '<scope input>', example: todo('a worked example value'), required: true },
+        ],
+        authority: { reads: [todo('what the operator may read')], changes: [todo('what the operator may change, or "nothing"')] },
+        limits: [todo('time, cost and scope limits')],
+        pauseRules: [
+            {
+                id: 'stop-on-ambiguity',
+                trigger: todo('the situation that makes the operator stop'),
+                owner: todo('who decides'),
+                mayContinue: todo('work that may continue meanwhile'),
+                resumeWhen: todo('the condition for resuming'),
+            },
+        ],
+        acceptanceChecks: ['check-primary', 'check-comparability'],
+        reportBack: [
+            { id: 'findings', label: 'Findings', description: todo('what the operator returns') },
+            { id: 'gaps', label: 'Gaps', description: 'Anything that could not be established, stated as a gap rather than guessed.' },
+        ],
+        operatorReference: {
+            entries: operatorEntries.map((e) => ({ id: e.id, digest: sha256Digest(normalizeText(files[e.path])) })),
+        },
+    })}\n`;
+    const check = (id, what) => ({
+        id,
+        observable: todo(`what is observed for ${what}`),
+        evidenceSource: todo('where the evidence comes from'),
+        passCondition: todo('what counts as a pass'),
+        onMissing: todo('what to do when the evidence is missing'),
+        onContradictory: todo('what to do when the evidence contradicts'),
+    });
+    files['checks.yaml'] = `${yml({
+        schemaVersion: SCHEMA_VERSION,
+        checks: [check('check-primary', 'the main result'), check('check-comparability', 'comparability')],
+        results: [
+            {
+                id: 'result-usable',
+                label: 'A usable result',
+                kind: 'usable',
+                verdict: 'usable',
+                summary: todo('why this result can be used'),
+                checks: [
+                    { check: 'check-primary', outcome: 'pass', observation: todo('what was observed'), evidence: ['source:source-1'] },
+                    { check: 'check-comparability', outcome: 'pass', observation: todo('what was observed'), evidence: ['source:source-1'] },
+                ],
+                completedActions: [todo('what the operator completed')],
+                observations: [todo('what the operator observed')],
+                gaps: [],
+                nextSteps: [todo('the recommended next step')],
+            },
+            {
+                id: 'result-flawed',
+                label: 'A plausible failure',
+                kind: 'flawed',
+                verdict: 'invalid',
+                summary: todo('why this result looks right but is not'),
+                checks: [
+                    { check: 'check-primary', outcome: 'pass', observation: todo('what was observed'), evidence: ['source:source-1'] },
+                    { check: 'check-comparability', outcome: 'fail', observation: todo('what exposes the problem'), evidence: ['source:source-1'] },
+                ],
+                completedActions: [todo('what the operator completed')],
+                observations: [todo('what the operator observed')],
+                gaps: [todo('what could not be established')],
+                nextSteps: [todo('the recommended next step')],
+                recovery: todo('how to recover'),
+            },
+        ],
+    })}\n`;
+    files['sources.yaml'] = `${yml({
+        schemaVersion: SCHEMA_VERSION,
+        sources: [
+            {
+                id: 'source-1',
+                title: todo('source title'),
+                kind: 'document',
+                version: todo('version or retrieval date'),
+                locator: todo('URL, path or citation'),
+                synthetic: true,
+                visibility: 'private',
+            },
+        ],
+        claims: [
+            { id: 'claim-1', text: todo('a material claim the guide makes'), status: 'supported', evidence: [{ source: 'source-1', locator: todo('where in the source') }] },
+        ],
+        checkEvidence: [
+            { check: 'check-primary', evidence: [{ source: 'source-1', locator: todo('where in the source') }] },
+            { check: 'check-comparability', evidence: [{ source: 'source-1', locator: todo('where in the source') }] },
+        ],
+    })}\n`;
+    files['assets.yaml'] = `${yml({ schemaVersion: SCHEMA_VERSION, assets: [] })}\n`;
+    return {
+        guideId,
+        recipe: recipe.id,
+        files: Object.fromEntries(Object.entries(files).sort(([a], [b]) => (a < b ? -1 : 1))),
+    };
+}
+/** Create a bundle and report its revision, computed by the same reader every adapter uses. */
+export async function createGuide(input) {
+    const created = scaffoldGuide(input);
+    const model = await readGuide(memorySource(created.files, created.guideId));
+    return { ...created, revision: model.revision };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/dist/sdk.d.ts

@@ -0,0 +1,56 @@
+import { type BuildOptionsInput, type BuildResult, type PreviewRequest, type PreviewResult, type SourceRef, type ValidateResult, type ValidationMode } from './contracts/index.js';
+import { type ArtifactBuild } from './build.js';
+import { type GuideModel } from './model.js';
+import { BundleFiles, type BundleLimits, type BundleSource } from './source.js';
+import { sha256Digest } from './util.js';
+/** Anything the SDK can read a bundle from. A string is a local directory path. */
+export type GuideInput = string | BundleSource | BundleFiles | SourceRef;
+export interface ReadOptions {
+    /** Allow `{ kind: 'path' }` references (local adapters only). Default true. */
+    allowPath?: boolean;
+    limits?: BundleLimits;
+}
+export declare function resolveInput(input: GuideInput, options?: ReadOptions): Promise<BundleSource | BundleFiles>;
+/** Read and parse a bundle into the normalized model. Never throws for bad bundle content. */
+export declare function loadGuide(input: GuideInput, options?: ReadOptions): Promise<GuideModel>;
+export interface ValidateGuideOptions extends ReadOptions {
+    mode?: ValidationMode;
+    audience?: 'private' | 'public';
+}
+export declare function validateGuide(input: GuideInput, options?: ValidateGuideOptions): Promise<ValidateResult>;
+export declare function previewGuide(input: GuideInput, request?: Partial<Omit<PreviewRequest, 'source'>> & ReadOptions): Promise<PreviewResult>;
+export interface BuildGuideOptions extends BuildOptionsInput, ReadOptions {
+    /** Directory to deliver outputs to. Omit to keep the result in memory (see buildGuideArtifacts). */
+    out?: string;
+    overwrite?: boolean;
+    browserPath?: string;
+    signal?: AbortSignal;
+}
+/** Build and keep every output in memory. Used by the hosted service. */
+export declare function buildGuideArtifacts(input: GuideInput, options?: BuildGuideOptions): Promise<ArtifactBuild & {
+    guideId?: string;
+    revision?: string;
+    referenceRevision?: string;
+}>;
+export declare function buildGuide(input: GuideInput, options?: BuildGuideOptions): Promise<BuildResult>;
+/** Write a bundle (relative path -> text) to a directory. Refuses unsafe paths; requires overwrite for non-empty targets. */
+export declare function writeBundle(files: Record<string, string>, dir: string, options?: {
+    overwrite?: boolean;
+}): Promise<string[]>;
+export interface PinResult {
+    /** Updated brief.yaml text, or undefined if nothing changed. */
+    brief?: string;
+    entries: {
+        id: string;
+        digest: string;
+        changed: boolean;
+    }[];
+}
+/** Record the current digest of every pinned operator-reference entry in brief.yaml (keeps comments). */
+export declare function pinGuide(input: GuideInput, options?: ReadOptions & {
+    all?: boolean;
+}): Promise<PinResult>;
+/** Add explicit `{#anchor}` to headings that lack one so links survive heading edits. Returns changed files. */
+export declare function stabilizeAnchors(input: GuideInput, options?: ReadOptions): Promise<Record<string, string>>;
+export { sha256Digest };
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

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