@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/corpus-shape.js

@@ -1,402 +1,2 @@
-/**
- * @module sdk/corpus-shape
- *
- * Declares portable, versioned synthetic-workspace population shapes and
- * produces deterministic item plans for benchmarks, evaluations, and packages.
- */
-/** Stable schema identifier for portable corpus-shape specifications. */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fa4eb88d-f50e-59fa-be7f-0cfb42931a73")}catch(e){}}();
-export const PM_CORPUS_SHAPE_SCHEMA = "https://schema.unbrained.dev/pm/corpus-shape/v1";
-function positiveInteger(value, field) {
-    if (!Number.isSafeInteger(value) || value <= 0) {
-        throw new TypeError(`Corpus shape ${field} must be a positive safe integer`);
-    }
-    return value;
-}
-function nonNegativeInteger(value, field) {
-    if (!Number.isSafeInteger(value) || value < 0) {
-        throw new TypeError(`Corpus shape ${field} must be a non-negative safe integer`);
-    }
-    return value;
-}
-function deepFreeze(value) {
-    if (typeof value !== "object" || value === null || Object.isFrozen(value)) {
-        return;
-    }
-    for (const nested of Object.values(value)) {
-        deepFreeze(nested);
-    }
-    Object.freeze(value);
-}
-/** Validate, detach, and deeply freeze a portable corpus-shape declaration. */
-export function defineCorpusShape(shape) {
-    if (shape.schema !== PM_CORPUS_SHAPE_SCHEMA) {
-        throw new TypeError(`Unsupported corpus shape schema: ${shape.schema}`);
-    }
-    if (shape.name.trim().length === 0 || shape.description.trim().length === 0) {
-        throw new TypeError("Corpus shape name and description must be non-empty");
-    }
-    positiveInteger(shape.hierarchy_depth, "hierarchy_depth");
-    positiveInteger(shape.hierarchy_fanout, "hierarchy_fanout");
-    nonNegativeInteger(shape.age_span_days, "age_span_days");
-    positiveInteger(shape.history_entries_per_item, "history_entries_per_item");
-    nonNegativeInteger(shape.comments_per_100_items, "comments_per_100_items");
-    nonNegativeInteger(shape.notes_per_100_items, "notes_per_100_items");
-    nonNegativeInteger(shape.learnings_per_100_items, "learnings_per_100_items");
-    positiveInteger(shape.author_cardinality, "author_cardinality");
-    positiveInteger(shape.component_count, "component_count");
-    if (shape.edge_kind_mix.length === 0 ||
-        shape.edge_kind_mix.some((edge) => edge.kind.trim().length === 0 || edge.weight <= 0)) {
-        throw new TypeError("Corpus shape edge_kind_mix requires non-empty kinds with positive weights");
-    }
-    if (shape.terminal_statuses.some((status) => !shape.custom_statuses.includes(status))) {
-        throw new TypeError("Corpus shape terminal_statuses must be declared in custom_statuses");
-    }
-    const detached = structuredClone(shape);
-    deepFreeze(detached);
-    return detached;
-}
-const COMMON_EDGE_MIX = [
-    { kind: "implements", weight: 5 },
-    { kind: "blocked_by", weight: 2 },
-    { kind: "discovered_from", weight: 2 },
-    { kind: "verifies", weight: 2 },
-    { kind: "supersedes", weight: 1 },
-    { kind: "related", weight: 4 },
-];
-/** Canonical built-in corpus shapes used by repository and downstream gates. */
-export const BUILTIN_CORPUS_SHAPES = Object.freeze({
-    scratch: defineCorpusShape({
-        schema: PM_CORPUS_SHAPE_SCHEMA,
-        name: "scratch",
-        description: "Seconds-old, shallow project with minimal history.",
-        hierarchy_depth: 2,
-        hierarchy_fanout: 50,
-        age_span_days: 0,
-        history_entries_per_item: 1,
-        comments_per_100_items: 2,
-        notes_per_100_items: 1,
-        learnings_per_100_items: 1,
-        edge_kind_mix: [{ kind: "related", weight: 1 }],
-        author_cardinality: 2,
-        component_count: 1,
-        include_cycles: false,
-        custom_types: [],
-        custom_statuses: [],
-        terminal_statuses: [],
-        custom_fields: [],
-    }),
-    representative: defineCorpusShape({
-        schema: PM_CORPUS_SHAPE_SCHEMA,
-        name: "representative",
-        description: "Medium-lived project with rich evidence and typed lineage.",
-        hierarchy_depth: 5,
-        hierarchy_fanout: 8,
-        age_span_days: 730,
-        history_entries_per_item: 12,
-        comments_per_100_items: 30,
-        notes_per_100_items: 12,
-        learnings_per_100_items: 10,
-        edge_kind_mix: COMMON_EDGE_MIX,
-        author_cardinality: 32,
-        component_count: 1,
-        include_cycles: false,
-        custom_types: ["Experiment"],
-        custom_statuses: ["review"],
-        terminal_statuses: [],
-        custom_fields: ["domain"],
-    }),
-    "deep-graph": defineCorpusShape({
-        schema: PM_CORPUS_SHAPE_SCHEMA,
-        name: "deep-graph",
-        description: "Deep typed relationship graph with deterministic cycles.",
-        hierarchy_depth: 16,
-        hierarchy_fanout: 2,
-        age_span_days: 3650,
-        history_entries_per_item: 6,
-        comments_per_100_items: 15,
-        notes_per_100_items: 8,
-        learnings_per_100_items: 8,
-        edge_kind_mix: COMMON_EDGE_MIX,
-        author_cardinality: 16,
-        component_count: 1,
-        include_cycles: true,
-        custom_types: [],
-        custom_statuses: [],
-        terminal_statuses: [],
-        custom_fields: [],
-    }),
-    "multi-decade": defineCorpusShape({
-        schema: PM_CORPUS_SHAPE_SCHEMA,
-        name: "multi-decade",
-        description: "Thirty-year event history with dense per-item evolution.",
-        hierarchy_depth: 6,
-        hierarchy_fanout: 6,
-        age_span_days: 10_958,
-        history_entries_per_item: 24,
-        comments_per_100_items: 40,
-        notes_per_100_items: 20,
-        learnings_per_100_items: 16,
-        edge_kind_mix: COMMON_EDGE_MIX,
-        author_cardinality: 64,
-        component_count: 1,
-        include_cycles: false,
-        custom_types: ["Program"],
-        custom_statuses: ["archived"],
-        terminal_statuses: ["archived"],
-        custom_fields: ["portfolio"],
-    }),
-    "disconnected-archive": defineCorpusShape({
-        schema: PM_CORPUS_SHAPE_SCHEMA,
-        name: "disconnected-archive",
-        description: "Multiple disconnected historical project components.",
-        hierarchy_depth: 4,
-        hierarchy_fanout: 10,
-        age_span_days: 7305,
-        history_entries_per_item: 8,
-        comments_per_100_items: 10,
-        notes_per_100_items: 5,
-        learnings_per_100_items: 6,
-        edge_kind_mix: COMMON_EDGE_MIX,
-        author_cardinality: 24,
-        component_count: 5,
-        include_cycles: false,
-        custom_types: ["Archive"],
-        custom_statuses: ["archived"],
-        terminal_statuses: ["archived"],
-        custom_fields: ["archive_source"],
-    }),
-});
-/** Return all built-in corpus-shape declarations in stable name order. */
-export function listBuiltinCorpusShapes() {
-    return Object.keys(BUILTIN_CORPUS_SHAPES)
-        .sort()
-        .map((name) => BUILTIN_CORPUS_SHAPES[name]);
-}
-/** Resolve one built-in corpus shape or reject an unknown name. */
-export function resolveBuiltinCorpusShape(name) {
-    const normalized = name.trim().toLowerCase();
-    if (!Object.hasOwn(BUILTIN_CORPUS_SHAPES, normalized)) {
-        throw new TypeError(`Unknown corpus shape "${name}". Available: ${Object.keys(BUILTIN_CORPUS_SHAPES).join(", ")}`);
-    }
-    return BUILTIN_CORPUS_SHAPES[normalized];
-}
-const expandedEdgeKinds = new WeakMap();
-function selectedEdgeKinds(index, shape) {
-    if (index === 0) {
-        return [];
-    }
-    let expanded = expandedEdgeKinds.get(shape);
-    if (expanded === undefined) {
-        expanded = shape.edge_kind_mix.flatMap((entry) => Array.from({ length: entry.weight }, () => entry.kind));
-        expandedEdgeKinds.set(shape, expanded);
-    }
-    const kinds = [expanded[index % expanded.length]];
-    if (shape.include_cycles && index > 2 && index % 17 === 0) {
-        kinds.push("related");
-    }
-    return [...new Set(kinds)];
-}
-/** Build one deterministic corpus item plan without filesystem side effects. */
-export function buildCorpusShapeItemPlan(shape, index, itemCount, seed = 42) {
-    nonNegativeInteger(index, "item index");
-    positiveInteger(itemCount, "item count");
-    if (index >= itemCount) {
-        throw new RangeError(`Corpus item index ${index} exceeds ${itemCount}`);
-    }
-    const componentCount = Math.min(shape.component_count, itemCount);
-    const component = index % componentCount;
-    const componentPosition = Math.floor(index / componentCount);
-    let hierarchyCapacity = 0;
-    let levelWidth = 1;
-    for (let depth = 0; depth < shape.hierarchy_depth; depth += 1) {
-        hierarchyCapacity = Math.min(Number.MAX_SAFE_INTEGER, hierarchyCapacity + levelWidth);
-        levelWidth = Math.min(Number.MAX_SAFE_INTEGER, levelWidth * shape.hierarchy_fanout);
-    }
-    const treeOffset = componentPosition % hierarchyCapacity;
-    const treeStart = componentPosition - treeOffset;
-    const parentIndex = treeOffset === 0
-        ? undefined
-        : component +
-            (treeStart + Math.floor((treeOffset - 1) / shape.hierarchy_fanout)) *
-                componentCount;
-    const base = Date.UTC(2026, 0, 1);
-    const spanMs = shape.age_span_days * 86_400_000;
-    const timestamp = new Date(base +
-        (itemCount === 1 ? 0 : Math.round((index / (itemCount - 1)) * spanMs))).toISOString();
-    const annotationBucket = (index * 37 + seed) % 100;
-    return {
-        index,
-        id: `pm-s${index.toString(36).padStart(7, "0")}`,
-        ...(parentIndex === undefined
-            ? {}
-            : {
-                parent: `pm-s${parentIndex.toString(36).padStart(7, "0")}`,
-            }),
-        component,
-        timestamp,
-        author: `pm-corpus-agent-${(index + seed) % Math.min(shape.author_cardinality, itemCount)}`,
-        history_entry_count: shape.history_entries_per_item,
-        dependency_kinds: selectedEdgeKinds(index, shape),
-        has_comment: annotationBucket < shape.comments_per_100_items,
-        has_note: annotationBucket < shape.notes_per_100_items,
-        has_learning: annotationBucket < shape.learnings_per_100_items,
-        ...(shape.custom_types.length > 0 && index % 11 === 0
-            ? { custom_type: shape.custom_types[index % shape.custom_types.length] }
-            : {}),
-        ...(shape.custom_statuses.length > 0 && index % 13 === 0
-            ? {
-                custom_status: shape.custom_statuses[index % shape.custom_statuses.length],
-            }
-            : {}),
-    };
-}
-/** Stateful incremental measurement that bounds retained population metadata. */
-class IncrementalCorpusShapeMeasurement {
-    shape;
-    authors = new Set();
-    components = new Set();
-    depths = new Map();
-    childCounts = new Map();
-    edgeKinds = {};
-    expectedEdgeKinds = {};
-    annotations = { comments: 0, notes: 0, learnings: 0 };
-    annotationFields;
-    planMismatches = [];
-    itemCount = 0;
-    observedDepth = 0;
-    observedFanout = 0;
-    historyEntryCount = 0;
-    firstTimestamp = null;
-    lastTimestamp = null;
-    /** Capture the declaration and its annotation-rate contracts. */
-    constructor(shape) {
-        this.shape = shape;
-        this.annotationFields = [
-            ["comments", "has_comment", shape.comments_per_100_items],
-            ["notes", "has_note", shape.notes_per_100_items],
-            ["learnings", "has_learning", shape.learnings_per_100_items],
-        ];
-    }
-    /** Retain one deterministic conformance mismatch when its predicate fails. */
-    recordMismatch(mismatched, message) {
-        if (mismatched)
-            this.planMismatches.push(message);
-    }
-    /** Accumulate a sequence of relationship kinds into one count table. */
-    recordEdgeKinds(counts, kinds) {
-        for (const kind of kinds)
-            counts[kind] = (counts[kind] ?? 0) + 1;
-    }
-    /** Add one generated plan in generation order. */
-    add(plan) {
-        this.itemCount += 1;
-        this.authors.add(plan.author);
-        this.components.add(plan.component);
-        this.recordMismatch(this.depths.has(plan.id), `duplicate_id:${plan.id}`);
-        let depth = 1;
-        if (plan.parent !== undefined) {
-            const parentDepth = this.depths.get(plan.parent);
-            this.recordMismatch(parentDepth === undefined, `parent_missing:${plan.parent}`);
-            depth = (parentDepth ?? 0) + 1;
-            const childCount = (this.childCounts.get(plan.parent) ?? 0) + 1;
-            this.childCounts.set(plan.parent, childCount);
-            this.observedFanout = Math.max(this.observedFanout, childCount);
-        }
-        this.depths.set(plan.id, depth);
-        this.observedDepth = Math.max(this.observedDepth, depth);
-        this.historyEntryCount += plan.history_entry_count;
-        this.recordMismatch(plan.history_entry_count !== this.shape.history_entries_per_item, "history_entries_per_item:drift");
-        this.firstTimestamp =
-            this.firstTimestamp === null || plan.timestamp < this.firstTimestamp
-                ? plan.timestamp
-                : this.firstTimestamp;
-        this.lastTimestamp =
-            this.lastTimestamp === null || plan.timestamp > this.lastTimestamp
-                ? plan.timestamp
-                : this.lastTimestamp;
-        for (const [annotation, property] of this.annotationFields) {
-            this.annotations[annotation] += Number(plan[property]);
-        }
-        this.recordEdgeKinds(this.edgeKinds, plan.dependency_kinds);
-        this.recordEdgeKinds(this.expectedEdgeKinds, selectedEdgeKinds(plan.index, this.shape));
-    }
-    /** Finish the measurement and return its conformance profile. */
-    finish() {
-        const expectedAuthors = Math.min(this.shape.author_cardinality, this.itemCount);
-        const expectedComponents = Math.min(this.shape.component_count, this.itemCount);
-        const mismatches = [
-            ...this.planMismatches,
-            ...(this.itemCount === 0 ? ["item_count:empty"] : []),
-            ...(this.authors.size === expectedAuthors
-                ? []
-                : [`author_count:${this.authors.size}!=${expectedAuthors}`]),
-            ...(this.components.size === expectedComponents
-                ? []
-                : [`component_count:${this.components.size}!=${expectedComponents}`]),
-            ...(this.observedDepth <= this.shape.hierarchy_depth
-                ? []
-                : [
-                    `hierarchy_depth:${this.observedDepth}>${this.shape.hierarchy_depth}`,
-                ]),
-            ...(this.observedFanout <= this.shape.hierarchy_fanout
-                ? []
-                : [
-                    `hierarchy_fanout:${this.observedFanout}>${this.shape.hierarchy_fanout}`,
-                ]),
-        ];
-        for (const [annotation, , rate] of this.annotationFields) {
-            const completeBuckets = Math.floor(this.itemCount / 100);
-            const remainder = this.itemCount % 100;
-            const minimum = completeBuckets * rate + Math.max(0, rate + remainder - 100);
-            const maximum = completeBuckets * rate + Math.min(rate, remainder);
-            const observed = this.annotations[annotation];
-            if (observed < minimum || observed > maximum) {
-                mismatches.push(`${annotation}:${observed}!in[${minimum},${maximum}]`);
-            }
-        }
-        const edgeKindNames = new Set([
-            ...Object.keys(this.edgeKinds),
-            ...Object.keys(this.expectedEdgeKinds),
-        ]);
-        for (const kind of [...edgeKindNames].sort()) {
-            const observed = this.edgeKinds[kind] ?? 0;
-            const expected = this.expectedEdgeKinds[kind] ?? 0;
-            if (observed !== expected) {
-                mismatches.push(`edge_kind:${kind}:${observed}!=${expected}`);
-            }
-        }
-        const uniqueMismatches = [...new Set(mismatches)];
-        return {
-            shape: this.shape.name,
-            item_count: this.itemCount,
-            author_count: this.authors.size,
-            component_count: this.components.size,
-            hierarchy_depth: this.observedDepth,
-            hierarchy_fanout: this.observedFanout,
-            timestamp_range: {
-                first: this.firstTimestamp,
-                last: this.lastTimestamp,
-            },
-            history_entry_count: this.historyEntryCount,
-            annotations: { ...this.annotations },
-            edge_kinds: { ...this.edgeKinds },
-            matches_declaration: uniqueMismatches.length === 0,
-            mismatches: uniqueMismatches,
-        };
-    }
-}
-/** Create an incremental measurement for a generated corpus population. */
-export function createCorpusShapeMeasurement(shape) {
-    return new IncrementalCorpusShapeMeasurement(shape);
-}
-/** Measure a generated plan and fail closed when declared invariants drift. */
-export function measureCorpusShapePlan(shape, plans) {
-    const measurement = createCorpusShapeMeasurement(shape);
-    for (const plan of plans)
-        measurement.add(plan);
-    return measurement.finish();
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9394fb87-fb36-5886-b262-ce2787326053")}catch(e2){}})();const PM_CORPUS_SHAPE_SCHEMA="https://schema.unbrained.dev/pm/corpus-shape/v1";function positiveInteger(value,field){if(!Number.isSafeInteger(value)||value<=0){throw new TypeError(`Corpus shape ${field} must be a positive safe integer`)}return value}function nonNegativeInteger(value,field){if(!Number.isSafeInteger(value)||value<0){throw new TypeError(`Corpus shape ${field} must be a non-negative safe integer`)}return value}function deepFreeze(value){if(typeof value!=="object"||value===null||Object.isFrozen(value)){return}for(const nested of Object.values(value)){deepFreeze(nested)}Object.freeze(value)}function defineCorpusShape(shape){if(shape.schema!==PM_CORPUS_SHAPE_SCHEMA){throw new TypeError(`Unsupported corpus shape schema: ${shape.schema}`)}if(shape.name.trim().length===0||shape.description.trim().length===0){throw new TypeError("Corpus shape name and description must be non-empty")}positiveInteger(shape.hierarchy_depth,"hierarchy_depth");positiveInteger(shape.hierarchy_fanout,"hierarchy_fanout");nonNegativeInteger(shape.age_span_days,"age_span_days");positiveInteger(shape.history_entries_per_item,"history_entries_per_item");nonNegativeInteger(shape.comments_per_100_items,"comments_per_100_items");nonNegativeInteger(shape.notes_per_100_items,"notes_per_100_items");nonNegativeInteger(shape.learnings_per_100_items,"learnings_per_100_items");positiveInteger(shape.author_cardinality,"author_cardinality");positiveInteger(shape.component_count,"component_count");if(shape.edge_kind_mix.length===0||shape.edge_kind_mix.some(edge=>edge.kind.trim().length===0||edge.weight<=0)){throw new TypeError("Corpus shape edge_kind_mix requires non-empty kinds with positive weights")}if(shape.terminal_statuses.some(status=>!shape.custom_statuses.includes(status))){throw new TypeError("Corpus shape terminal_statuses must be declared in custom_statuses")}const detached=structuredClone(shape);deepFreeze(detached);return detached}const COMMON_EDGE_MIX=[{kind:"implements",weight:5},{kind:"blocked_by",weight:2},{kind:"discovered_from",weight:2},{kind:"verifies",weight:2},{kind:"supersedes",weight:1},{kind:"related",weight:4}];const BUILTIN_CORPUS_SHAPES=Object.freeze({scratch:defineCorpusShape({schema:PM_CORPUS_SHAPE_SCHEMA,name:"scratch",description:"Seconds-old, shallow project with minimal history.",hierarchy_depth:2,hierarchy_fanout:50,age_span_days:0,history_entries_per_item:1,comments_per_100_items:2,notes_per_100_items:1,learnings_per_100_items:1,edge_kind_mix:[{kind:"related",weight:1}],author_cardinality:2,component_count:1,include_cycles:false,custom_types:[],custom_statuses:[],terminal_statuses:[],custom_fields:[]}),representative:defineCorpusShape({schema:PM_CORPUS_SHAPE_SCHEMA,name:"representative",description:"Medium-lived project with rich evidence and typed lineage.",hierarchy_depth:5,hierarchy_fanout:8,age_span_days:730,history_entries_per_item:12,comments_per_100_items:30,notes_per_100_items:12,learnings_per_100_items:10,edge_kind_mix:COMMON_EDGE_MIX,author_cardinality:32,component_count:1,include_cycles:false,custom_types:["Experiment"],custom_statuses:["review"],terminal_statuses:[],custom_fields:["domain"]}),"deep-graph":defineCorpusShape({schema:PM_CORPUS_SHAPE_SCHEMA,name:"deep-graph",description:"Deep typed relationship graph with deterministic cycles.",hierarchy_depth:16,hierarchy_fanout:2,age_span_days:3650,history_entries_per_item:6,comments_per_100_items:15,notes_per_100_items:8,learnings_per_100_items:8,edge_kind_mix:COMMON_EDGE_MIX,author_cardinality:16,component_count:1,include_cycles:true,custom_types:[],custom_statuses:[],terminal_statuses:[],custom_fields:[]}),"multi-decade":defineCorpusShape({schema:PM_CORPUS_SHAPE_SCHEMA,name:"multi-decade",description:"Thirty-year event history with dense per-item evolution.",hierarchy_depth:6,hierarchy_fanout:6,age_span_days:10958,history_entries_per_item:24,comments_per_100_items:40,notes_per_100_items:20,learnings_per_100_items:16,edge_kind_mix:COMMON_EDGE_MIX,author_cardinality:64,component_count:1,include_cycles:false,custom_types:["Program"],custom_statuses:["archived"],terminal_statuses:["archived"],custom_fields:["portfolio"]}),"disconnected-archive":defineCorpusShape({schema:PM_CORPUS_SHAPE_SCHEMA,name:"disconnected-archive",description:"Multiple disconnected historical project components.",hierarchy_depth:4,hierarchy_fanout:10,age_span_days:7305,history_entries_per_item:8,comments_per_100_items:10,notes_per_100_items:5,learnings_per_100_items:6,edge_kind_mix:COMMON_EDGE_MIX,author_cardinality:24,component_count:5,include_cycles:false,custom_types:["Archive"],custom_statuses:["archived"],terminal_statuses:["archived"],custom_fields:["archive_source"]})});function listBuiltinCorpusShapes(){return Object.keys(BUILTIN_CORPUS_SHAPES).sort().map(name=>BUILTIN_CORPUS_SHAPES[name])}function resolveBuiltinCorpusShape(name){const normalized=name.trim().toLowerCase();if(!Object.hasOwn(BUILTIN_CORPUS_SHAPES,normalized)){throw new TypeError(`Unknown corpus shape "${name}". Available: ${Object.keys(BUILTIN_CORPUS_SHAPES).join(", ")}`)}return BUILTIN_CORPUS_SHAPES[normalized]}const expandedEdgeKinds=new WeakMap;function selectedEdgeKinds(index,shape){if(index===0){return[]}let expanded=expandedEdgeKinds.get(shape);if(expanded===void 0){expanded=shape.edge_kind_mix.flatMap(entry=>Array.from({length:entry.weight},()=>entry.kind));expandedEdgeKinds.set(shape,expanded)}const kinds=[expanded[index%expanded.length]];if(shape.include_cycles&&index>2&&index%17===0){kinds.push("related")}return[...new Set(kinds)]}function buildCorpusShapeItemPlan(shape,index,itemCount,seed=42){nonNegativeInteger(index,"item index");positiveInteger(itemCount,"item count");if(index>=itemCount){throw new RangeError(`Corpus item index ${index} exceeds ${itemCount}`)}const componentCount=Math.min(shape.component_count,itemCount);const component=index%componentCount;const componentPosition=Math.floor(index/componentCount);let hierarchyCapacity=0;let levelWidth=1;for(let depth=0;depth<shape.hierarchy_depth;depth+=1){hierarchyCapacity=Math.min(Number.MAX_SAFE_INTEGER,hierarchyCapacity+levelWidth);levelWidth=Math.min(Number.MAX_SAFE_INTEGER,levelWidth*shape.hierarchy_fanout)}const treeOffset=componentPosition%hierarchyCapacity;const treeStart=componentPosition-treeOffset;const parentIndex=treeOffset===0?void 0:component+(treeStart+Math.floor((treeOffset-1)/shape.hierarchy_fanout))*componentCount;const base=Date.UTC(2026,0,1);const spanMs=shape.age_span_days*864e5;const timestamp=new Date(base+(itemCount===1?0:Math.round(index/(itemCount-1)*spanMs))).toISOString();const annotationBucket=(index*37+seed)%100;return{index,id:`pm-s${index.toString(36).padStart(7,"0")}`,...parentIndex===void 0?{}:{parent:`pm-s${parentIndex.toString(36).padStart(7,"0")}`},component,timestamp,author:`pm-corpus-agent-${(index+seed)%Math.min(shape.author_cardinality,itemCount)}`,history_entry_count:shape.history_entries_per_item,dependency_kinds:selectedEdgeKinds(index,shape),has_comment:annotationBucket<shape.comments_per_100_items,has_note:annotationBucket<shape.notes_per_100_items,has_learning:annotationBucket<shape.learnings_per_100_items,...shape.custom_types.length>0&&index%11===0?{custom_type:shape.custom_types[index%shape.custom_types.length]}:{},...shape.custom_statuses.length>0&&index%13===0?{custom_status:shape.custom_statuses[index%shape.custom_statuses.length]}:{}}}class IncrementalCorpusShapeMeasurement{shape;authors=new Set;components=new Set;depths=new Map;childCounts=new Map;edgeKinds={};expectedEdgeKinds={};annotations={comments:0,notes:0,learnings:0};annotationFields;planMismatches=[];itemCount=0;observedDepth=0;observedFanout=0;historyEntryCount=0;firstTimestamp=null;lastTimestamp=null;constructor(shape){this.shape=shape;this.annotationFields=[["comments","has_comment",shape.comments_per_100_items],["notes","has_note",shape.notes_per_100_items],["learnings","has_learning",shape.learnings_per_100_items]]}recordMismatch(mismatched,message){if(mismatched)this.planMismatches.push(message)}recordEdgeKinds(counts,kinds){for(const kind of kinds)counts[kind]=(counts[kind]??0)+1}add(plan){this.itemCount+=1;this.authors.add(plan.author);this.components.add(plan.component);this.recordMismatch(this.depths.has(plan.id),`duplicate_id:${plan.id}`);let depth=1;if(plan.parent!==void 0){const parentDepth=this.depths.get(plan.parent);this.recordMismatch(parentDepth===void 0,`parent_missing:${plan.parent}`);depth=(parentDepth??0)+1;const childCount=(this.childCounts.get(plan.parent)??0)+1;this.childCounts.set(plan.parent,childCount);this.observedFanout=Math.max(this.observedFanout,childCount)}this.depths.set(plan.id,depth);this.observedDepth=Math.max(this.observedDepth,depth);this.historyEntryCount+=plan.history_entry_count;this.recordMismatch(plan.history_entry_count!==this.shape.history_entries_per_item,"history_entries_per_item:drift");this.firstTimestamp=this.firstTimestamp===null||plan.timestamp<this.firstTimestamp?plan.timestamp:this.firstTimestamp;this.lastTimestamp=this.lastTimestamp===null||plan.timestamp>this.lastTimestamp?plan.timestamp:this.lastTimestamp;for(const[annotation,property]of this.annotationFields){this.annotations[annotation]+=Number(plan[property])}this.recordEdgeKinds(this.edgeKinds,plan.dependency_kinds);this.recordEdgeKinds(this.expectedEdgeKinds,selectedEdgeKinds(plan.index,this.shape))}finish(){const expectedAuthors=Math.min(this.shape.author_cardinality,this.itemCount);const expectedComponents=Math.min(this.shape.component_count,this.itemCount);const mismatches=[...this.planMismatches,...this.itemCount===0?["item_count:empty"]:[],...this.authors.size===expectedAuthors?[]:[`author_count:${this.authors.size}!=${expectedAuthors}`],...this.components.size===expectedComponents?[]:[`component_count:${this.components.size}!=${expectedComponents}`],...this.observedDepth<=this.shape.hierarchy_depth?[]:[`hierarchy_depth:${this.observedDepth}>${this.shape.hierarchy_depth}`],...this.observedFanout<=this.shape.hierarchy_fanout?[]:[`hierarchy_fanout:${this.observedFanout}>${this.shape.hierarchy_fanout}`]];for(const[annotation,,rate]of this.annotationFields){const completeBuckets=Math.floor(this.itemCount/100);const remainder=this.itemCount%100;const minimum=completeBuckets*rate+Math.max(0,rate+remainder-100);const maximum=completeBuckets*rate+Math.min(rate,remainder);const observed=this.annotations[annotation];if(observed<minimum||observed>maximum){mismatches.push(`${annotation}:${observed}!in[${minimum},${maximum}]`)}}const edgeKindNames=new Set([...Object.keys(this.edgeKinds),...Object.keys(this.expectedEdgeKinds)]);for(const kind of[...edgeKindNames].sort()){const observed=this.edgeKinds[kind]??0;const expected=this.expectedEdgeKinds[kind]??0;if(observed!==expected){mismatches.push(`edge_kind:${kind}:${observed}!=${expected}`)}}const uniqueMismatches=[...new Set(mismatches)];return{shape:this.shape.name,item_count:this.itemCount,author_count:this.authors.size,component_count:this.components.size,hierarchy_depth:this.observedDepth,hierarchy_fanout:this.observedFanout,timestamp_range:{first:this.firstTimestamp,last:this.lastTimestamp},history_entry_count:this.historyEntryCount,annotations:{...this.annotations},edge_kinds:{...this.edgeKinds},matches_declaration:uniqueMismatches.length===0,mismatches:uniqueMismatches}}}function createCorpusShapeMeasurement(shape){return new IncrementalCorpusShapeMeasurement(shape)}function measureCorpusShapePlan(shape,plans){const measurement=createCorpusShapeMeasurement(shape);for(const plan of plans)measurement.add(plan);return measurement.finish()}export{BUILTIN_CORPUS_SHAPES,PM_CORPUS_SHAPE_SCHEMA,buildCorpusShapeItemPlan,createCorpusShapeMeasurement,defineCorpusShape,listBuiltinCorpusShapes,measureCorpusShapePlan,resolveBuiltinCorpusShape};
 //# sourceMappingURL=corpus-shape.js.map
-//# debugId=fa4eb88d-f50e-59fa-be7f-0cfb42931a73

package/dist/sdk/define.js

@@ -1,221 +1,2 @@
-/**
- * Type an extension's in-module manifest mirror (the `manifest` export / field).
- *
- * Completes the `define*` family: the manifest is the one authoring surface that
- * otherwise had no builder. Contract-checks the object against
- * {@link ExtensionManifest} where it is authored, catching a missing required
- * field or a mistyped key at edit time instead of at load time. Pair with
- * {@link ./compose.js#deriveExtensionCapabilities | `deriveExtensionCapabilities`}
- * to keep `capabilities` matched to the surfaces the extension actually registers.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e37a2da9-966f-5044-bc5e-d27ddb07e65b")}catch(e){}}();
-export function defineExtensionManifest(manifest) {
-    return manifest;
-}
-/**
- * Type a project-profile definition for the profile registry.
- *
- * A profile bundles item types, statuses, fields, per-type workflows, config
- * knobs, create templates, and package recommendations into one declarative
- * archetype that `pm profile apply` stages idempotently. This builder checks the
- * object against {@link ProjectProfileDefinition} where it is authored — catching
- * an invalid field type or a malformed workflow at edit time — while preserving
- * the literal `name`/`types`/`statuses` so a package's archetype stays strongly
- * typed at the definition site, mirroring {@link defineItemType}. It is the
- * authoring anchor a first-party or third-party profile package builds on.
- */
-export function defineProjectProfile(profile) {
-    return profile;
-}
-/**
- * Type a command definition for `api.registerCommand(definition)`.
- *
- * Checks the object against {@link CommandDefinition} and infers the `run`
- * handler's `context` parameter while preserving the literal `name`/`action`
- * types. Pass the result straight to `registerCommand`, or export it so the
- * command can be invoked in tests via `runRegisteredCommandForTest`.
- */
-export function defineCommand(definition) {
-    return definition;
-}
-/**
- * Type a single flag definition for a `api.registerFlags(command, flags)` array.
- *
- * Authors compose builders into the array
- * (`api.registerFlags("list", [defineFlag({ long: "--mine" })])`) to get
- * per-flag contract checking — `value_type`, `list`, and `default` included —
- * instead of validating a loosely-typed literal array all at once.
- */
-export function defineFlag(flag) {
-    return flag;
-}
-/**
- * Type a custom item-type definition for `api.registerItemTypes([...])`.
- *
- * Preserves the literal `name`/`folder`/`aliases` so a project archetype's
- * domain types stay strongly typed where the definition is declared and reused.
- */
-export function defineItemType(type) {
-    return type;
-}
-/**
- * Type a custom item-metadata field definition for `api.registerItemFields([...])`.
- *
- * Checks `name`/`type`/`optional` against {@link SchemaFieldDefinition} while
- * keeping the field's extra metadata (the contract carries an index signature)
- * intact.
- */
-export function defineItemField(field) {
-    return field;
-}
-/**
- * Type a schema migration definition for `api.registerMigration(definition)`.
- *
- * Preserves the literal `id` and, when `run` is provided, infers the migration
- * runner's context, so the same definition can be registered and later exercised
- * through `runRegisteredMigrationForTest`.
- */
-export function defineMigration(migration) {
-    return migration;
-}
-/**
- * Type a search-provider definition for `api.registerSearchProvider(provider)`.
- *
- * Infers the `query`/`embed`/`embedBatch` operation contexts and result shapes
- * so a custom retrieval backend is type-checked at the definition site and
- * reusable in `runRegisteredSearchProviderForTest`.
- */
-export function defineSearchProvider(provider) {
-    return provider;
-}
-/**
- * Type a vector-store adapter definition for `api.registerVectorStoreAdapter(adapter)`.
- *
- * Infers the `query`/`upsert`/`delete` operation contexts so a package that owns
- * its own semantic index storage gets contract checking before activation and a
- * definition it can drive through `runRegisteredVectorStoreAdapterForTest`.
- */
-export function defineVectorStoreAdapter(adapter) {
-    return adapter;
-}
-/**
- * Type a command-override handler for `api.registerCommand(command, override)`.
- *
- * The non-generic signature lets TypeScript contextually type the override's
- * `context` parameter from {@link CommandOverride}, so a bare arrow authored in
- * a `.js` package still gets a fully-typed argument.
- */
-export function defineCommandOverride(override) {
-    return override;
-}
-/**
- * Type a parser-override handler for `api.registerParser(command, override)`.
- *
- * Contextually types the `context` parameter and the returned
- * {@link ParserOverride} delta so an argument-rewriting override is checked
- * where it is written.
- */
-export function defineParserOverride(override) {
-    return override;
-}
-/** Implement the preflight authoring identity for callbacks and scoped definitions. */
-export function definePreflightOverride(override) {
-    return override;
-}
-/**
- * Type a service-override handler for `api.registerService(service, override)`.
- *
- * Contextually types the `context` parameter from {@link ServiceOverride} so a
- * package overriding a built-in service (output formatting, embeddings, and the
- * like) keeps its handler argument typed without an explicit annotation.
- */
-export function defineServiceOverride(override) {
-    return override;
-}
-/** Explicitly claim a service payload and publish its replacement result. */
-export function handleServiceOverride(result) {
-    return { handled: true, result };
-}
-/** Explicitly decline a service payload so the next override or host handles it. */
-export function declineServiceOverride() {
-    return { handled: false };
-}
-/** Implement the renderer authoring identity for callback and scoped definitions. */
-export function defineRendererOverride(renderer) {
-    return renderer;
-}
-/**
- * Type an importer handler for `api.registerImporter(name, importer, options)`.
- *
- * Contextually types the {@link Importer} `context` (registration, args,
- * options, pm root) so the bridge from an external system into the pm context
- * graph is type-checked and reusable in `runRegisteredImporterForTest`.
- */
-export function defineImporter(importer) {
-    return importer;
-}
-/**
- * Type an exporter handler for `api.registerExporter(name, exporter, options)`.
- *
- * Contextually types the {@link Exporter} `context` so the bridge from the pm
- * context graph out to an external system is checked at the definition site and
- * reusable in `runRegisteredExporterForTest`.
- */
-export function defineExporter(exporter) {
-    return exporter;
-}
-/**
- * Type a `before_command` hook for `api.hooks.beforeCommand(hook)`.
- *
- * Contextually types the {@link BeforeCommandHook} `context` so a hook that
- * inspects or annotates a command before it runs keeps its argument typed when
- * authored as a standalone, exportable, testable value.
- */
-export function defineBeforeCommandHook(hook) {
-    return hook;
-}
-/** Type a fail-closed `before_mutation` guard for `api.hooks.beforeMutation(hook)`. */
-export function defineBeforeMutationHook(hook) {
-    return hook;
-}
-/**
- * Type an `after_command` hook for `api.hooks.afterCommand(hook)`.
- *
- * Contextually types the {@link AfterCommandHook} `context` — including the
- * `affected` items pm mutated — so the natural place to react to every change
- * ("project management = context management") is checked where it is written.
- */
-export function defineAfterCommandHook(hook) {
-    return hook;
-}
-/**
- * Type an `on_write` hook for `api.hooks.onWrite(hook)`.
- *
- * Contextually types the {@link OnWriteHook} `context` so a hook reacting to
- * item persistence keeps its argument typed without an explicit annotation.
- */
-export function defineOnWriteHook(hook) {
-    return hook;
-}
-/**
- * Type an `on_read` hook for `api.hooks.onRead(hook)`.
- *
- * Contextually types the {@link OnReadHook} `context` so a hook augmenting items
- * as they are read is type-checked at the definition site.
- */
-export function defineOnReadHook(hook) {
-    return hook;
-}
-/**
- * Type an `on_index` hook for `api.hooks.onIndex(hook)`.
- *
- * Contextually types the {@link OnIndexHook} `context` so a hook participating
- * in index/search refresh keeps its argument typed even without TypeScript
- * annotations.
- */
-export function defineOnIndexHook(hook) {
-    return hook;
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a169a68c-13d0-5a3a-b231-abdf1a34ef6a")}catch(e2){}})();function defineExtensionManifest(manifest){return manifest}function defineProjectProfile(profile){return profile}function defineCommand(definition){return definition}function defineFlag(flag){return flag}function defineItemType(type){return type}function defineItemField(field){return field}function defineMigration(migration){return migration}function defineSearchProvider(provider){return provider}function defineVectorStoreAdapter(adapter){return adapter}function defineCommandOverride(override){return override}function defineParserOverride(override){return override}function definePreflightOverride(override){return override}function defineServiceOverride(override){return override}function handleServiceOverride(result){return{handled:true,result}}function declineServiceOverride(){return{handled:false}}function defineRendererOverride(renderer){return renderer}function defineImporter(importer){return importer}function defineExporter(exporter){return exporter}function defineBeforeCommandHook(hook){return hook}function defineBeforeMutationHook(hook){return hook}function defineAfterCommandHook(hook){return hook}function defineOnWriteHook(hook){return hook}function defineOnReadHook(hook){return hook}function defineOnIndexHook(hook){return hook}export{declineServiceOverride,defineAfterCommandHook,defineBeforeCommandHook,defineBeforeMutationHook,defineCommand,defineCommandOverride,defineExporter,defineExtensionManifest,defineFlag,defineImporter,defineItemField,defineItemType,defineMigration,defineOnIndexHook,defineOnReadHook,defineOnWriteHook,defineParserOverride,definePreflightOverride,defineProjectProfile,defineRendererOverride,defineSearchProvider,defineServiceOverride,defineVectorStoreAdapter,handleServiceOverride};
 //# sourceMappingURL=define.js.map
-//# debugId=e37a2da9-966f-5044-bc5e-d27ddb07e65b