youmd 0.6.21 → 0.6.27

package/dist/lib/stackSafety.js

@@ -0,0 +1,486 @@
+"use strict";
+/**
+ * stackSafety.ts — machine-checkable T0-T3 safety contract for YouStack manifests.
+ *
+ * SELF-IMPROVING-SYSTEM-DESIGN.md §4 defines the four tiers:
+ *   T0  read-only suggestions (diagnostics, inspect, brief)
+ *   T1  additive writes to local scratch, always logged
+ *   T2  modify skills/stacks/identity sections — propose-only unless mode grants more
+ *   T3  visibility widening, publishing, remote push, deletions, irreversible ops
+ *
+ * Mode semantics (enforced, not advisory):
+ *   observe         → read-only; smoke/guard FAIL (not warn) if write_local capability exists
+ *   propose         → writes only to proposals/ directory
+ *   auto_pr         → branch + PR, never main; requires humanGate.required === true
+ *   auto_apply_local→ requires improvement.evals non-empty AND evals green
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSafetyContract = parseSafetyContract;
+exports.validateSafetyContract = validateSafetyContract;
+exports.tierAllows = tierAllows;
+exports.inferCapabilitiesFromManifest = inferCapabilitiesFromManifest;
+exports.runStackGuard = runStackGuard;
+exports.checkModeConsistency = checkModeConsistency;
+exports.tierRefusalMessage = tierRefusalMessage;
+// ---------------------------------------------------------------------------
+// Tier rules (table from SELF-IMPROVING-SYSTEM-DESIGN.md §4)
+// ---------------------------------------------------------------------------
+// Regex patterns for capability hint inference.
+// We use word-boundary (\b) patterns to avoid false positives on common words
+// like "profile" triggering "pr", or "screen" triggering "create".
+/** Implies filesystem write access beyond read-only. */
+const FS_WRITE_RE = /\b(write|write_local|create|edit|save|update|generate|output|auto_apply|auto-apply|modify|patch)\b/i;
+/** Implies shell/subprocess execution. */
+const SHELL_RE = /\b(shell|exec|bash|script|subprocess)\b/i;
+/** Implies creating a pull request or pushing to a remote branch. */
+const AUTO_PR_RE = /\b(auto_pr|auto-pr|pull[_\s-]request|pull_request)\b/i;
+/** Implies outbound network access (beyond read-only identity retrieval). */
+const NETWORK_RE = /\b(network|http|fetch|api|remote|sync|upload|download|webhook)\b/i;
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Parse the `safety` section from a raw manifest object.
+ * Returns null if the section is absent.
+ */
+function parseSafetyContract(manifest) {
+    const raw = manifest["safety"];
+    if (!raw)
+        return null;
+    if (!isRecord(raw))
+        return null;
+    const tier = raw["tier"];
+    if (typeof tier !== "string" || !["T0", "T1", "T2", "T3"].includes(tier)) {
+        return null;
+    }
+    const capabilitiesRaw = raw["capabilities"];
+    const capabilities = isRecord(capabilitiesRaw)
+        ? {
+            fs_write: capabilitiesRaw["fs_write"] === true,
+            network: capabilitiesRaw["network"] === true,
+            shell: capabilitiesRaw["shell"] === true,
+            auto_pr: capabilitiesRaw["auto_pr"] === true,
+        }
+        : {};
+    const gateRaw = raw["humanGate"];
+    const humanGate = isRecord(gateRaw)
+        ? {
+            required: gateRaw["required"] === true,
+            scopes: Array.isArray(gateRaw["scopes"])
+                ? gateRaw["scopes"].filter((s) => typeof s === "string")
+                : undefined,
+        }
+        : { required: false };
+    return {
+        tier: tier,
+        capabilities,
+        humanGate,
+    };
+}
+// ---------------------------------------------------------------------------
+// Validation (tier rules)
+// ---------------------------------------------------------------------------
+/**
+ * Validate a safety contract against the T0-T3 tier rules.
+ *
+ * T0: no fs_write, no auto_pr, no shell.
+ * T1: no auto_pr.
+ * T2: auto_pr only if humanGate.required === true.
+ * T3: humanGate MUST list explicit scopes (non-empty).
+ */
+function validateSafetyContract(contract) {
+    const violations = [];
+    const warnings = [];
+    const { tier, capabilities, humanGate } = contract;
+    switch (tier) {
+        case "T0":
+            if (capabilities.fs_write) {
+                violations.push({
+                    capability: "fs_write",
+                    reason: "T0 stacks are read-only; fs_write is not allowed",
+                    tierRule: "T0: no fs_write, no auto_pr, no shell",
+                });
+            }
+            if (capabilities.auto_pr) {
+                violations.push({
+                    capability: "auto_pr",
+                    reason: "T0 stacks are read-only; auto_pr is not allowed",
+                    tierRule: "T0: no fs_write, no auto_pr, no shell",
+                });
+            }
+            if (capabilities.shell) {
+                violations.push({
+                    capability: "shell",
+                    reason: "T0 stacks are read-only; shell execution is not allowed",
+                    tierRule: "T0: no fs_write, no auto_pr, no shell",
+                });
+            }
+            break;
+        case "T1":
+            if (capabilities.auto_pr) {
+                violations.push({
+                    capability: "auto_pr",
+                    reason: "T1 stacks may write to local scratch only; auto_pr is not allowed",
+                    tierRule: "T1: no auto_pr",
+                });
+            }
+            break;
+        case "T2":
+            if (capabilities.auto_pr && humanGate.required !== true) {
+                violations.push({
+                    capability: "auto_pr",
+                    reason: "T2 stacks may use auto_pr only when humanGate.required is true",
+                    tierRule: "T2: auto_pr only if humanGate.required === true",
+                });
+            }
+            break;
+        case "T3":
+            if (!humanGate.scopes || humanGate.scopes.length === 0) {
+                violations.push({
+                    capability: "auto_pr",
+                    reason: "T3 stacks must list explicit humanGate.scopes for every autonomous action",
+                    tierRule: "T3: humanGate MUST list explicit scopes",
+                });
+            }
+            break;
+    }
+    if (tier !== "T3" && !humanGate.required && capabilities.auto_pr) {
+        warnings.push("auto_pr is declared without humanGate.required; ensure the mode policy enforces approval");
+    }
+    return {
+        ok: violations.length === 0,
+        violations,
+        warnings,
+    };
+}
+// ---------------------------------------------------------------------------
+// tierAllows — runtime capability check
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if the declared contract allows the given capability.
+ * Used by the guard and runtime routing hook.
+ */
+function tierAllows(contract, capability) {
+    const { tier, capabilities } = contract;
+    switch (capability) {
+        case "fs_write":
+            // T0: denied
+            if (tier === "T0")
+                return false;
+            return capabilities.fs_write === true;
+        case "shell":
+            // T0: denied
+            if (tier === "T0")
+                return false;
+            return capabilities.shell === true;
+        case "auto_pr":
+            // T0, T1: denied
+            if (tier === "T0" || tier === "T1")
+                return false;
+            // T2: only if humanGate.required
+            if (tier === "T2")
+                return capabilities.auto_pr === true && contract.humanGate.required === true;
+            // T3: declared + non-empty scopes
+            return (capabilities.auto_pr === true &&
+                Array.isArray(contract.humanGate.scopes) &&
+                contract.humanGate.scopes.length > 0);
+        case "network":
+            // T0 may do read-only network (e.g. fetching public identity)
+            // The design-doc says T0 is "read identity, brief, public profile" — always allowed
+            // So network is tier-gated by the declared flag
+            if (tier === "T0")
+                return capabilities.network !== false;
+            return capabilities.network !== false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Capability hint inference (for guard scanning)
+// ---------------------------------------------------------------------------
+function capabilityHints(cap) {
+    const text = [
+        cap.id,
+        cap.intent,
+        cap.workflow,
+        cap.skill,
+        cap.mcpTool,
+        cap.apiEndpoint,
+        cap.mutationPolicy,
+        ...(cap.requiredScopes || []),
+    ]
+        .filter(Boolean)
+        .join(" ");
+    return {
+        fs_write: FS_WRITE_RE.test(text),
+        shell: SHELL_RE.test(text),
+        auto_pr: AUTO_PR_RE.test(text),
+        network: NETWORK_RE.test(text),
+    };
+}
+/**
+ * Scan a manifest's declared capabilities (and improvement policy) for hints
+ * that imply specific capability flags. Returns what was inferred and which
+ * capability IDs triggered each flag.
+ */
+function inferCapabilitiesFromManifest(manifest) {
+    const result = {
+        fs_write: false,
+        shell: false,
+        auto_pr: false,
+        network: false,
+        sources: { fs_write: [], shell: [], auto_pr: [], network: [] },
+    };
+    for (const cap of manifest.capabilities || []) {
+        const hints = capabilityHints(cap);
+        if (hints.fs_write) {
+            result.fs_write = true;
+            result.sources.fs_write.push(cap.id);
+        }
+        if (hints.shell) {
+            result.shell = true;
+            result.sources.shell.push(cap.id);
+        }
+        if (hints.auto_pr) {
+            result.auto_pr = true;
+            result.sources.auto_pr.push(cap.id);
+        }
+        if (hints.network) {
+            result.network = true;
+            result.sources.network.push(cap.id);
+        }
+    }
+    // Also check improvement.mode
+    const mode = manifest.improvement?.mode;
+    if (mode === "auto_pr" || mode === "auto_apply_local") {
+        result.auto_pr = true;
+        if (!result.sources.auto_pr.includes("improvement.mode")) {
+            result.sources.auto_pr.push("improvement.mode");
+        }
+    }
+    if (mode === "auto_apply_local" || mode === "auto_pr") {
+        result.fs_write = true;
+        if (!result.sources.fs_write.includes("improvement.mode")) {
+            result.sources.fs_write.push("improvement.mode");
+        }
+    }
+    // Check evals array for auto_pr references
+    for (const evalEntry of manifest.improvement?.evals || []) {
+        if (AUTO_PR_RE.test(evalEntry)) {
+            result.auto_pr = true;
+            if (!result.sources.auto_pr.includes(`evals: ${evalEntry}`)) {
+                result.sources.auto_pr.push(`evals: ${evalEntry}`);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Run the full guard check against a loaded manifest.
+ * Called from the `youmd stack guard` subcommand and from runYouStackDoctor.
+ */
+function runStackGuard(manifest, manifestPath) {
+    const rawContract = parseSafetyContract(manifest);
+    const warnings = [];
+    const checks = [];
+    // Missing contract → treat as T0 with a warning
+    if (!rawContract) {
+        warnings.push("no safety contract declared; treating stack as T0 (read-only). " +
+            "Add a `safety` section to youstack.json to declare capabilities explicitly.");
+        const impliedContract = {
+            tier: "T0",
+            capabilities: {},
+            humanGate: { required: false },
+        };
+        const inferred = inferCapabilitiesFromManifest(manifest);
+        const caps = ["fs_write", "shell", "auto_pr", "network"];
+        for (const cap of caps) {
+            const allowed = tierAllows(impliedContract, cap);
+            const inf = inferred[cap];
+            const inferredFrom = inferred.sources[cap];
+            if (inf && !allowed) {
+                checks.push({
+                    capability: cap,
+                    status: "VIOLATION",
+                    declared: false,
+                    inferred: true,
+                    inferredFrom,
+                    tierRule: "T0: no fs_write, no auto_pr, no shell",
+                    message: `inferred ${cap} (from: ${inferredFrom.join(", ")}) but T0 contract disallows it`,
+                });
+            }
+            else {
+                checks.push({
+                    capability: cap,
+                    status: "PASS",
+                    declared: false,
+                    inferred: inf,
+                    inferredFrom,
+                    tierRule: allowed ? "allowed by T0" : "not applicable (not inferred)",
+                    message: inf ? `inferred ${cap} — T0 permits this capability` : `${cap} not inferred`,
+                });
+            }
+        }
+        const ok = checks.every((c) => c.status === "PASS");
+        return { ok, tier: "T0", manifestPath, checks, contractViolations: [], warnings };
+    }
+    // Validate the contract itself
+    const contractResult = validateSafetyContract(rawContract);
+    const inferred = inferCapabilitiesFromManifest(manifest);
+    const caps = ["fs_write", "shell", "auto_pr", "network"];
+    for (const cap of caps) {
+        const allowed = tierAllows(rawContract, cap);
+        const declared = rawContract.capabilities[cap] === true;
+        const inf = inferred[cap];
+        const inferredFrom = inferred.sources[cap];
+        // Check: inferred capability exceeds declared tier
+        if (inf && !allowed && !declared) {
+            checks.push({
+                capability: cap,
+                status: "VIOLATION",
+                declared,
+                inferred: inf,
+                inferredFrom,
+                tierRule: getTierRule(rawContract.tier, cap),
+                message: `inferred ${cap} (from: ${inferredFrom.join(", ")}) but ${rawContract.tier} contract does not permit it`,
+            });
+        }
+        else if (declared && !allowed) {
+            // Declared but tier doesn't permit
+            checks.push({
+                capability: cap,
+                status: "VIOLATION",
+                declared,
+                inferred: inf,
+                inferredFrom,
+                tierRule: getTierRule(rawContract.tier, cap),
+                message: `${cap} declared but ${rawContract.tier} tier rule prohibits it`,
+            });
+        }
+        else {
+            checks.push({
+                capability: cap,
+                status: "PASS",
+                declared,
+                inferred: inf,
+                inferredFrom,
+                tierRule: allowed ? `${rawContract.tier}: ${cap} allowed` : `${rawContract.tier}: ${cap} not applicable`,
+                message: declared
+                    ? `${cap} declared and allowed under ${rawContract.tier}`
+                    : inf
+                        ? `${cap} inferred and allowed under ${rawContract.tier}`
+                        : `${cap} not declared or inferred`,
+            });
+        }
+    }
+    warnings.push(...contractResult.warnings);
+    const ok = contractResult.ok && checks.every((c) => c.status === "PASS");
+    return {
+        ok,
+        tier: rawContract.tier,
+        manifestPath,
+        checks,
+        contractViolations: contractResult.violations,
+        warnings,
+    };
+}
+function getTierRule(tier, cap) {
+    const rules = {
+        T0: {
+            fs_write: "T0: no fs_write, no auto_pr, no shell",
+            shell: "T0: no fs_write, no auto_pr, no shell",
+            auto_pr: "T0: no fs_write, no auto_pr, no shell",
+            network: "T0: network allowed for read-only identity retrieval",
+        },
+        T1: {
+            fs_write: "T1: fs_write allowed to scratch only, always logged",
+            shell: "T1: shell allowed if declared",
+            auto_pr: "T1: no auto_pr",
+            network: "T1: network allowed if declared",
+        },
+        T2: {
+            fs_write: "T2: fs_write allowed",
+            shell: "T2: shell allowed if declared",
+            auto_pr: "T2: auto_pr only if humanGate.required === true",
+            network: "T2: network allowed if declared",
+        },
+        T3: {
+            fs_write: "T3: all declared capabilities allowed with explicit humanGate.scopes",
+            shell: "T3: all declared capabilities allowed with explicit humanGate.scopes",
+            auto_pr: "T3: all declared capabilities allowed with explicit humanGate.scopes",
+            network: "T3: all declared capabilities allowed with explicit humanGate.scopes",
+        },
+    };
+    return rules[tier][cap];
+}
+/**
+ * Mode-compatibility check: verifies the improvement.mode is consistent
+ * with the declared safety tier.
+ *
+ * `observe` → T0 or T1 only; smoke/guard FAIL if a write_local capability exists
+ * `propose` → T1 or T2; writes to proposals/ only
+ * `auto_pr` → T2 or T3; requires humanGate.required
+ * `auto_apply_local` → T2 or T3; requires non-empty evals
+ */
+function checkModeConsistency(manifest, contract) {
+    const mode = manifest.improvement?.mode;
+    const violations = [];
+    if (!mode)
+        return { ok: true, violations };
+    switch (mode) {
+        case "observe":
+            // Under observe, write_local capability → FAIL (not warn)
+            if (contract.capabilities.fs_write || contract.capabilities.shell) {
+                violations.push("improvement.mode is 'observe' but safety.capabilities declares fs_write or shell; " +
+                    "smoke and guard FAIL (not warn) under observe mode");
+            }
+            break;
+        case "propose":
+            if (contract.tier === "T0") {
+                violations.push("improvement.mode 'propose' requires at least T1 tier (T0 is read-only)");
+            }
+            break;
+        case "auto_pr":
+            if (contract.tier === "T0" || contract.tier === "T1") {
+                violations.push(`improvement.mode 'auto_pr' requires T2 or T3 tier; current tier is ${contract.tier}`);
+            }
+            if (!contract.humanGate.required) {
+                violations.push("improvement.mode 'auto_pr' requires humanGate.required to be true");
+            }
+            break;
+        case "auto_apply_local": {
+            if (contract.tier === "T0" || contract.tier === "T1") {
+                violations.push(`improvement.mode 'auto_apply_local' requires T2 or T3 tier; current tier is ${contract.tier}`);
+            }
+            const evals = manifest.improvement?.evals || [];
+            if (evals.length === 0) {
+                violations.push("improvement.mode 'auto_apply_local' requires improvement.evals to be non-empty");
+            }
+            break;
+        }
+    }
+    return { ok: violations.length === 0, violations };
+}
+/**
+ * Refusal message for runtime enforcement — the one-line message the routing
+ * hook emits when a request exceeds the declared tier.
+ */
+function tierRefusalMessage(contract, requestedCapability) {
+    const requiredTier = requiredTierForCapability(requestedCapability);
+    return (`blocked: stack is ${contract.tier} — this action needs ${requiredTier}. ` +
+        `Declare a higher tier in youstack.json safety.tier and rerun \`youmd stack guard\`.`);
+}
+function requiredTierForCapability(cap) {
+    switch (cap) {
+        case "fs_write":
+            return "T1 or higher";
+        case "shell":
+            return "T1 or higher";
+        case "auto_pr":
+            return "T2 or higher with humanGate.required=true";
+        case "network":
+            return "T1 or higher";
+    }
+}
+//# sourceMappingURL=stackSafety.js.map

package/dist/lib/stackSafety.js.map

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

package/dist/lib/stackUpdate.d.ts

@@ -0,0 +1,44 @@
+/**
+ * L17 — stack update channel.
+ *
+ * Checks the upstream registry for a newer version of a YouStack manifest.
+ * Falls back to the manifest's `update.source` field if no registry endpoint
+ * exists, querying the `repo` field in `owner` with `git ls-remote`.
+ *
+ * Contract:
+ *   - checkStackUpdate(loaded)  → StackUpdateInfo
+ *   - applyStackUpdate(loaded, info) → void (writes new files, does NOT commit)
+ */
+import type { LoadedYouStack } from "./youstack";
+export interface StackUpdateInfo {
+    /** Version string declared in the local manifest. */
+    currentVersion: string;
+    /** Version string from upstream. null when no upstream tag/manifest found. */
+    latestVersion: string | null;
+    /** Whether the upstream is ahead of local. */
+    updateAvailable: boolean;
+    /** Source used: "registry" | "git-ls-remote" | "source-url" | "none" */
+    source: "registry" | "git-ls-remote" | "source-url" | "none";
+    /** First line of upstream CHANGELOG.md, if present beside the manifest. */
+    changelogHint: string | null;
+    /** Human-readable status message (lowercase). */
+    message: string;
+}
+/**
+ * Check whether the upstream source (registry endpoint → manifest source URL
+ * → git ls-remote on owner.repo) has a version newer than the local manifest.
+ */
+export declare function checkStackUpdate(loaded: LoadedYouStack): Promise<StackUpdateInfo>;
+export interface StackApplyResult {
+    wrote: string[];
+    skipped: string[];
+    error: string | null;
+}
+/**
+ * Apply an update by fetching the manifest from update.source and writing it
+ * into place.  Only available when source is "source-url".
+ *
+ * Does NOT commit or push. Writes the new youstack.json at manifestPath.
+ */
+export declare function applyStackUpdate(loaded: LoadedYouStack): Promise<StackApplyResult>;
+//# sourceMappingURL=stackUpdate.d.ts.map

package/dist/lib/stackUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stackUpdate.d.ts","sourceRoot":"","sources":["../../src/lib/stackUpdate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8CAA8C;IAC9C,eAAe,EAAE,OAAO,CAAC;IACzB,wEAAwE;IACxE,MAAM,EAAE,UAAU,GAAG,eAAe,GAAG,YAAY,GAAG,MAAM,CAAC;IAC7D,2EAA2E;IAC3E,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;CACjB;AA6FD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,eAAe,CAAC,CA4E1B;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAkC3B"}