glirastes 0.3.2 → 0.5.0

package/dist/cli/commands/setup-plan.d.ts

@@ -0,0 +1,65 @@
+import { type AppSetupArtifact, type SemanticChange } from '../../contracts/index.js';
+import { type SetupProfile } from './setup-profile.js';
+export interface SetupPlanOperation {
+    kind: 'validate' | 'adopt' | 'build' | 'receipt' | 'sync';
+    path: string;
+    digest: string;
+}
+export interface SetupPlan {
+    schemaVersion: 1;
+    mode: 'standalone' | 'managed';
+    planDigest: string;
+    operations: SetupPlanOperation[];
+    counts: {
+        tools: number;
+        semanticChanges: number;
+    };
+    semanticChanges: SemanticChange[];
+    diagnostics: Array<{
+        code: string;
+        operation: string;
+    }>;
+    requiresConfirmation: boolean;
+}
+export interface CreateSetupPlanOptions {
+    rootDir: string;
+    artifactPath?: string;
+    previousArtifactPath?: string;
+    inventoryPath?: string;
+    promptBundlePath?: string;
+    managed?: boolean;
+}
+export interface SetupPlanContents {
+    mode: 'standalone' | 'managed';
+    paths: SetupProfile['paths'];
+    proposed: {
+        path: string;
+        raw: string;
+    };
+    /** Undefined when no previous artifact exists. */
+    previousRaw?: string;
+    inventoryRaw: string;
+    promptBundleRaw: string;
+}
+/** P02's classification, exported for the tools generator and the corpus tests. */
+export declare function compareArtifacts(previous: AppSetupArtifact | undefined, proposed: AppSetupArtifact): SemanticChange[];
+/** Pure plan core shared by file-based setup and the tools generator. */
+export declare function createSetupPlanFromContents(input: SetupPlanContents): SetupPlan;
+export declare function createSetupPlan(options: CreateSetupPlanOptions): Promise<SetupPlan>;
+/**
+ * The plan the tools generator records in `setup-receipt.json`: the committed
+ * artifact compared with itself, so the digest depends on committed outputs
+ * only and never on a previous artifact that `glirastes setup` left behind.
+ */
+export declare function createSelfSetupPlan(options: Omit<CreateSetupPlanOptions, 'previousArtifactPath'>): Promise<SetupPlan>;
+/**
+ * A receipt is current when its digest is the plan digest (written by
+ * `glirastes setup`) or the self-plan digest (written by `glirastes tools
+ * refresh`). The self-plan is computed only when the first comparison fails and
+ * an uncomputable self-plan rejects the receipt.
+ */
+export declare function acceptsReceiptPlanDigest(receiptPlanDigest: string, plan: SetupPlan, createSelfPlan: () => Promise<SetupPlan>): Promise<boolean>;
+export declare function assertSetupPlanConfirmation(plan: SetupPlan, confirmation: {
+    confirmLoosening?: boolean;
+    planDigest?: string;
+}): void;

package/dist/cli/commands/setup-plan.js

@@ -0,0 +1,234 @@
+import { createHash } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { AppSetupArtifactSchema, assertAppSetupSemanticParity, classifyToolSemanticChange, deriveToolPolicyDefaults, riskTier, } from '../../contracts/index.js';
+import { FoundationDiagnosticError } from '../../diagnostics/index.js';
+import { detectSetupProfile } from './setup-profile.js';
+function sha256(value) {
+    return `sha256:${createHash('sha256').update(value).digest('base64url')}`;
+}
+function boundedPath(rootDir, path) {
+    const absolute = resolve(rootDir, path);
+    const local = relative(resolve(rootDir), absolute);
+    if (local === ''
+        || local.startsWith('..')
+        || isAbsolute(local)
+        || local.length > 2_048) {
+        throw new FoundationDiagnosticError({
+            code: 'E-SETUP-003',
+            operation: 'setup.plan',
+            message: 'A setup artifact path is outside the workspace.',
+            remediation: 'choose-workspace-artifact-path',
+        });
+    }
+    return { absolute, relative: local };
+}
+async function readRaw(rootDir, path, required) {
+    const bounded = boundedPath(rootDir, path);
+    try {
+        return { raw: await readFile(bounded.absolute, 'utf8'), path: bounded.relative };
+    }
+    catch (error) {
+        if (!required && error.code === 'ENOENT') {
+            return undefined;
+        }
+        throw error;
+    }
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function resolvePreviousArtifactPath(rootDir, proposedPath, canonicalPath, configuredPath, defaultPreviousPath) {
+    if (configuredPath)
+        return configuredPath;
+    const previous = boundedPath(rootDir, defaultPreviousPath);
+    if (await exists(previous.absolute))
+        return previous.relative;
+    if (proposedPath === canonicalPath)
+        return proposedPath;
+    const canonical = boundedPath(rootDir, canonicalPath);
+    if (await exists(canonical.absolute))
+        return canonical.relative;
+    return undefined;
+}
+/**
+ * A tool that is new in the proposal needs no confirmation when its policy is
+ * at least as strict as the deterministic defaults for its route. Only a
+ * committed relaxation below those defaults stays a confirmable loosening.
+ */
+function classifyNewTool(tool) {
+    const defaults = deriveToolPolicyDefaults({
+        executionKind: tool.executionKind,
+        ...(tool.method ? { method: tool.method } : {}),
+        ...(tool.path ? { path: tool.path } : {}),
+        definitionId: tool.name,
+    });
+    const relaxedFields = [];
+    if (riskTier(tool.riskClass) < riskTier(defaults.riskClass)) {
+        relaxedFields.push('riskClass');
+    }
+    const approvalExpected = defaults.requiresApproval
+        || riskTier(tool.riskClass) >= 2;
+    if (approvalExpected && !tool.requiresApproval) {
+        relaxedFields.push('requiresApproval');
+    }
+    if (relaxedFields.length === 0) {
+        return {
+            toolId: tool.toolId,
+            classification: 'added',
+            fields: ['toolId'],
+            requiresConfirmation: false,
+        };
+    }
+    return {
+        toolId: tool.toolId,
+        classification: 'loosening',
+        fields: ['toolId', ...relaxedFields],
+        requiresConfirmation: true,
+    };
+}
+/** P02's classification, exported for the tools generator and the corpus tests. */
+export function compareArtifacts(previous, proposed) {
+    const previousTools = previous?.tools ?? [];
+    const proposedById = new Map(proposed.tools.map((tool) => [tool.toolId, tool]));
+    const previousById = new Map(previousTools.map((tool) => [tool.toolId, tool]));
+    const changes = proposed.tools.map((tool) => {
+        const before = previousById.get(tool.toolId);
+        return before
+            ? classifyToolSemanticChange(before, tool)
+            : classifyNewTool(tool);
+    });
+    for (const tool of previousTools) {
+        if (!proposedById.has(tool.toolId)) {
+            changes.push({
+                toolId: tool.toolId,
+                classification: 'hardening',
+                fields: ['toolId'],
+                requiresConfirmation: false,
+            });
+        }
+    }
+    return changes.sort((left, right) => left.toolId.localeCompare(right.toolId));
+}
+/** Pure plan core shared by file-based setup and the tools generator. */
+export function createSetupPlanFromContents(input) {
+    const proposed = AppSetupArtifactSchema.parse(JSON.parse(input.proposed.raw));
+    const previous = input.previousRaw === undefined
+        ? undefined
+        : AppSetupArtifactSchema.parse(JSON.parse(input.previousRaw));
+    assertAppSetupSemanticParity(proposed, proposed.tools.map((tool) => tool.name));
+    if (previous) {
+        assertAppSetupSemanticParity(previous, previous.tools.map((tool) => tool.name));
+    }
+    const semanticChanges = compareArtifacts(previous, proposed);
+    const proposedDigest = sha256(input.proposed.raw);
+    const buildInputDigest = sha256(JSON.stringify({
+        setup: proposedDigest,
+        inventory: sha256(input.inventoryRaw),
+        promptBundle: sha256(input.promptBundleRaw),
+    }));
+    const body = {
+        schemaVersion: 1,
+        mode: input.mode,
+        operations: [
+            { kind: 'validate', path: input.proposed.path, digest: proposedDigest },
+            { kind: 'adopt', path: input.paths.canonicalSetupArtifact, digest: proposedDigest },
+            { kind: 'build', path: input.paths.buildDir, digest: buildInputDigest },
+            { kind: 'receipt', path: input.paths.receipt, digest: proposedDigest },
+            ...(input.mode === 'managed' ? [{
+                    kind: 'sync',
+                    path: input.proposed.path,
+                    digest: proposedDigest,
+                }] : []),
+        ],
+        counts: {
+            tools: proposed.tools.length,
+            semanticChanges: semanticChanges.length,
+        },
+        semanticChanges,
+        diagnostics: [],
+        requiresConfirmation: semanticChanges.some((change) => change.requiresConfirmation),
+    };
+    return { ...body, planDigest: sha256(JSON.stringify(body)) };
+}
+async function readLeftoverArtifact(options, profile, proposedPath) {
+    const previousPath = await resolvePreviousArtifactPath(options.rootDir, proposedPath, profile.paths.canonicalSetupArtifact, options.previousArtifactPath, profile.paths.previousSetupArtifact);
+    const previous = await readRaw(options.rootDir, previousPath ?? profile.paths.previousSetupArtifact, false);
+    return previous?.raw;
+}
+/** `leftover` compares with the previous artifact on disk; `self` with the proposal itself. */
+async function createFileBasedSetupPlan(options, previousSource) {
+    const profile = await detectSetupProfile({
+        rootDir: options.rootDir,
+        managed: options.managed,
+        artifactPath: options.artifactPath,
+        inventoryPath: options.inventoryPath,
+        promptBundlePath: options.promptBundlePath,
+    });
+    const proposed = await readRaw(options.rootDir, profile.paths.setupArtifact, true);
+    if (!proposed)
+        throw new Error('unreachable');
+    const previousRaw = previousSource === 'self'
+        ? proposed.raw
+        : await readLeftoverArtifact(options, profile, proposed.path);
+    const inventory = await readRaw(options.rootDir, profile.paths.inventory, true);
+    const promptBundle = await readRaw(options.rootDir, profile.paths.promptBundle, true);
+    return createSetupPlanFromContents({
+        mode: profile.mode,
+        paths: profile.paths,
+        proposed,
+        ...(previousRaw === undefined ? {} : { previousRaw }),
+        inventoryRaw: inventory.raw,
+        promptBundleRaw: promptBundle.raw,
+    });
+}
+export async function createSetupPlan(options) {
+    return createFileBasedSetupPlan(options, 'leftover');
+}
+/**
+ * The plan the tools generator records in `setup-receipt.json`: the committed
+ * artifact compared with itself, so the digest depends on committed outputs
+ * only and never on a previous artifact that `glirastes setup` left behind.
+ */
+export async function createSelfSetupPlan(options) {
+    return createFileBasedSetupPlan(options, 'self');
+}
+/**
+ * A receipt is current when its digest is the plan digest (written by
+ * `glirastes setup`) or the self-plan digest (written by `glirastes tools
+ * refresh`). The self-plan is computed only when the first comparison fails and
+ * an uncomputable self-plan rejects the receipt.
+ */
+export async function acceptsReceiptPlanDigest(receiptPlanDigest, plan, createSelfPlan) {
+    if (receiptPlanDigest === plan.planDigest)
+        return true;
+    try {
+        return receiptPlanDigest === (await createSelfPlan()).planDigest;
+    }
+    catch {
+        return false;
+    }
+}
+export function assertSetupPlanConfirmation(plan, confirmation) {
+    if (!plan.requiresConfirmation)
+        return;
+    if (!confirmation.confirmLoosening
+        || confirmation.planDigest !== plan.planDigest) {
+        throw new FoundationDiagnosticError({
+            code: 'E-SEMANTICS-004',
+            operation: 'setup.plan-confirmation',
+            message: 'A semantic loosening requires confirmation of this exact plan.',
+            remediation: 'confirm-plan-digest',
+            identifier: plan.planDigest,
+        });
+    }
+}
+//# sourceMappingURL=setup-plan.js.map

package/dist/cli/commands/setup-plan.js.map

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

package/dist/cli/commands/setup-profile.d.ts

@@ -0,0 +1,28 @@
+import { type DetectedStack } from './installer-parts.js';
+export interface SetupProfile {
+    schemaVersion: 1;
+    projectName: string | null;
+    framework: DetectedStack | null;
+    authProviders: string[];
+    principal: 'server-verified' | null;
+    mode: 'standalone' | 'managed';
+    appId: string;
+    toolCount: number;
+    paths: {
+        inventory: string;
+        setupArtifact: string;
+        canonicalSetupArtifact: string;
+        previousSetupArtifact: string;
+        promptBundle: string;
+        buildDir: string;
+        receipt: string;
+    };
+}
+export interface DetectSetupProfileOptions {
+    rootDir: string;
+    managed?: boolean;
+    artifactPath?: string;
+    inventoryPath?: string;
+    promptBundlePath?: string;
+}
+export declare function detectSetupProfile(options: DetectSetupProfileOptions): Promise<SetupProfile>;

package/dist/cli/commands/setup-profile.js

@@ -0,0 +1,152 @@
+import { readFile, stat } from 'node:fs/promises';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { z } from 'zod';
+import { FoundationExecutionInventorySchema } from '../../codegen/index.js';
+import { AppSetupArtifactSchema } from '../../contracts/index.js';
+import { FoundationDiagnosticError } from '../../diagnostics/index.js';
+import { detectStack } from './installer-parts.js';
+const relativePath = z.string().trim().min(1).max(2_048);
+const PackageGlirastesSchema = z.object({
+    principal: z.literal('server-verified').optional(),
+    setupArtifact: relativePath.optional(),
+    inventory: relativePath.optional(),
+    promptBundle: relativePath.optional(),
+}).passthrough();
+const PackageSchema = z.object({
+    name: z.string().trim().min(1).max(214).optional(),
+    dependencies: z.record(z.string(), z.string()).optional(),
+    devDependencies: z.record(z.string(), z.string()).optional(),
+    glirastes: PackageGlirastesSchema.optional(),
+}).passthrough();
+const PromptIdentitySchema = z.object({
+    schemaVersion: z.literal(1),
+    appId: z.uuid(),
+}).passthrough();
+const AUTH_MARKERS = [
+    ['@azure/msal-node', 'entra'],
+    ['@auth0/nextjs-auth0', 'auth0'],
+    ['@clerk/nextjs', 'clerk'],
+    ['@supabase/ssr', 'supabase'],
+    ['@auth/core', 'authjs'],
+    ['next-auth', 'authjs'],
+    ['better-auth', 'better-auth'],
+];
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+function boundedPath(rootDir, path) {
+    const absolute = resolve(rootDir, path);
+    const local = relative(resolve(rootDir), absolute);
+    if (!local
+        || local.startsWith('..')
+        || isAbsolute(local)
+        || local.length > 2_048) {
+        throw new FoundationDiagnosticError({
+            code: 'E-SETUP-003',
+            operation: 'setup.profile',
+            message: 'A configured setup path is outside the workspace.',
+            remediation: 'choose-workspace-artifact-path',
+        });
+    }
+    return { absolute, relative: local };
+}
+async function requiredJson(rootDir, path, schema) {
+    const bounded = boundedPath(rootDir, path);
+    try {
+        return schema.parse(JSON.parse(await readFile(bounded.absolute, 'utf8')));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new FoundationDiagnosticError({
+                code: 'E-SETUP-005',
+                operation: 'setup.profile',
+                message: 'A required local setup artifact is missing.',
+                remediation: 'create-required-setup-artifact',
+                path: bounded.relative,
+            });
+        }
+        throw error;
+    }
+}
+async function resolveCandidate(rootDir, configured, candidates) {
+    if (configured)
+        return boundedPath(rootDir, configured).relative;
+    const found = [];
+    for (const candidate of candidates) {
+        const bounded = boundedPath(rootDir, candidate);
+        if (await exists(bounded.absolute))
+            found.push(bounded.relative);
+    }
+    if (found.length > 1) {
+        throw new FoundationDiagnosticError({
+            code: 'E-SETUP-004',
+            operation: 'setup.profile',
+            message: 'Several local setup artifacts match the same purpose.',
+            remediation: 'configure-canonical-artifact-path',
+        });
+    }
+    return found[0] ?? boundedPath(rootDir, candidates[0]).relative;
+}
+export async function detectSetupProfile(options) {
+    const rootDir = resolve(options.rootDir);
+    const packageJson = PackageSchema.parse(JSON.parse(await readFile(resolve(rootDir, 'package.json'), 'utf8')));
+    const configured = packageJson.glirastes;
+    const setupArtifactPath = await resolveCandidate(rootDir, options.artifactPath ?? configured?.setupArtifact, [
+        '.glirastes/setup-artifact.json',
+        '.glirastes/app-setup-artifact.json',
+    ]);
+    const inventoryPath = await resolveCandidate(rootDir, options.inventoryPath ?? configured?.inventory, [
+        '.glirastes/foundation-execution-inventory.json',
+        '.glirastes/local-execution-inventory.v2.json',
+    ]);
+    const promptBundlePath = await resolveCandidate(rootDir, options.promptBundlePath ?? configured?.promptBundle, ['.glirastes/prompt-bundle.json']);
+    const [setupArtifact, inventory, promptIdentity] = await Promise.all([
+        requiredJson(rootDir, setupArtifactPath, AppSetupArtifactSchema),
+        requiredJson(rootDir, inventoryPath, FoundationExecutionInventorySchema),
+        requiredJson(rootDir, promptBundlePath, PromptIdentitySchema),
+    ]);
+    if (setupArtifact.appId !== promptIdentity.appId) {
+        throw new FoundationDiagnosticError({
+            code: 'E-SCOPE-002',
+            operation: 'setup.profile',
+            message: 'Local setup artifacts disagree on the application identity.',
+            remediation: 'align-local-app-identity',
+        });
+    }
+    const declaredDependencies = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies,
+    };
+    const authProviders = [...new Set(AUTH_MARKERS
+            .filter(([dependency]) => dependency in declaredDependencies)
+            .map(([, provider]) => provider))]
+        .sort((left, right) => left.localeCompare(right));
+    return {
+        schemaVersion: 1,
+        projectName: packageJson.name ?? null,
+        framework: await detectStack(rootDir),
+        authProviders,
+        principal: configured?.principal ?? null,
+        mode: options.managed ? 'managed' : 'standalone',
+        appId: setupArtifact.appId,
+        toolCount: inventory.executions.length,
+        paths: {
+            inventory: inventoryPath,
+            setupArtifact: setupArtifactPath,
+            canonicalSetupArtifact: '.glirastes/setup-artifact.json',
+            previousSetupArtifact: '.glirastes/previous-setup-artifact.json',
+            promptBundle: promptBundlePath,
+            buildDir: '.glirastes/build',
+            receipt: '.glirastes/setup-receipt.json',
+        },
+    };
+}
+//# sourceMappingURL=setup-profile.js.map

package/dist/cli/commands/setup-profile.js.map

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

package/dist/cli/commands/setup-wizard.d.ts

@@ -0,0 +1,66 @@
+import { type InstallerPart } from './installer-parts.js';
+/** Where the wizard remembers how far it got. */
+export declare const WIZARD_STATE_PATH = ".glirastes/setup-wizard-state.json";
+export declare const WIZARD_STEPS: readonly ["skills", "scan", "assess", "validate", "sync"];
+export type WizardStep = (typeof WIZARD_STEPS)[number];
+export type InstallHost = 'codex' | 'claude' | 'gemini';
+export declare const INSTALL_HOSTS: readonly ["codex", "claude", "gemini"];
+/**
+ * How the tool descriptions, roles and prompt groups get written.
+ *
+ * `interview` and `autonomous` are both carried out by the setup skill, so both
+ * require it — there is nothing to choose. `manual` is the way out for an
+ * operator who writes the artifact themselves, and is the only mode where the
+ * setup skill is genuinely optional.
+ */
+export declare const ASSESSMENT_MODES: readonly ["interview", "autonomous", "manual"];
+export type AssessmentMode = (typeof ASSESSMENT_MODES)[number];
+/** Whether this mode is carried out by the setup skill. */
+export declare function requiresSetupSkill(mode: AssessmentMode): boolean;
+/**
+ * The wizard stopped on purpose and the operator has something to do before it
+ * can continue. Distinct from a failure: re-running resumes.
+ */
+export declare class WizardStopped extends Error {
+    constructor(message: string);
+}
+export interface WizardIo {
+    isInteractive: boolean;
+    log(message: string): void;
+    ask(question: string): Promise<string>;
+}
+export interface WizardDependencies {
+    installSkills(options: {
+        rootDir: string;
+        hosts: ReadonlyArray<InstallHost>;
+        parts: ReadonlyArray<InstallerPart>;
+    }): Promise<void>;
+    discover(rootDir: string): Promise<{
+        executionCount: number;
+    }>;
+    /** Whether the assessment has produced its artifact yet. */
+    assessmentArtifactExists(rootDir: string): Promise<boolean>;
+    /** Whether a provider credential for autonomous assessment is configured. */
+    hasProviderCredential(): boolean;
+    validate(rootDir: string): Promise<void>;
+    sync(rootDir: string): Promise<{
+        runId: string;
+    }>;
+}
+export interface SetupWizardOptions {
+    rootDir: string;
+    io: WizardIo;
+    /** One or several agent hosts. */
+    hosts?: ReadonlyArray<InstallHost>;
+    parts?: ReadonlyArray<InstallerPart>;
+    assessmentMode?: AssessmentMode;
+    deps: WizardDependencies;
+}
+export interface SetupWizardResult {
+    runId: string;
+}
+/** The legacy interview is available only through `setup guided`. */
+export declare function isWizardInvocation(rest: ReadonlyArray<string>): boolean;
+export declare function runSetupWizard(options: SetupWizardOptions): Promise<SetupWizardResult>;
+/** Default dependencies, wired to the real commands. */
+export declare function defaultWizardDependencies(): Pick<WizardDependencies, 'installSkills' | 'hasProviderCredential'>;