{ "pack_id": "self-constructing-node-and-waterfall", "title": "Self-constructing node and waterfall", "version": "0.1.0", "summary": "A collection of nouns and verbs for stateless contract-hydrated worker nodes, continuous per-step state profiling, keyword-triggered fresh resource hydration, weighted deterministic-to-harness waterfalls, multi-persona vector ratings and capability-gap spinout proposals.", "dependencies": [ "configuration-grids-and-bounds", "loops-schedules-and-heuristics", "execution-hooks-and-verifiers", "trigger-and-shim-rules" ], "boundaries": [ "Workers remain stateless claimants of Tessera verbs and never create a rival task, scheduler or policy authority.", "Unserved-signature spinout proposals stay in proposed_verbs and require distinct-reviewer verification before block admission.", "Deterministic cache, keyword hydration and typed code blocks always run before model or CLI harness rungs when applicable.", "Importing the pack writes nothing, enqueues nothing and installs no code." ], "nouns": [ { "slug": "pack", "category": "noun.skill_pack", "role": "pack", "title": "A collection of nouns and verbs for stateless contract-hydrated worker nodes, weighted deterministic-to-harness waterfalls, multi-persona vector scoring and capability-gap spinout proposals", "value": { "lets_workers": "Hydrate stateless worker nodes from operating, waterfall, behavior and output contracts, interrogate envelopes via 5W1H plus temporal horizon, short-circuit solved states via ContinuousStepProfiler, pull recently updated (< 6h) context via deterministic keyword triggers, explore K strategies (reuse, compose, modify, build_new) across a five-rung deterministic-to-CLI-harness waterfall (opencode, pi, codex), score outputs across five stakeholder personas and six vector dimensions and propose background capability-builder verbs when repeated unserved query shapes hit quorum.", "flow": [ { "verb": { "$verb": "self-constructing-node-and-waterfall.interrogate-and-profile-envelope" }, "when": "Decompose an input envelope across 5W1H plus temporal horizon, compute exact and shape hashes, short-circuit solved states and hydrate fresh (< 6h) external resources from keyword triggers." }, { "verb": { "$verb": "self-constructing-node-and-waterfall.execute-weighted-waterfall-and-harness-grid" }, "when": "Explore K candidate strategies (reuse, compose, modify, build_new) and execute the lowest-cost admissible rung across deterministic code blocks, hybrid synthesis or isolated CLI harness cells." }, { "verb": { "$verb": "self-constructing-node-and-waterfall.evaluate-persona-vectors-and-spinout-gap" }, "when": "Score candidate outputs across five stakeholder personas and six vector dimensions, propose cheaper deterministic distillations and emit background capability-builder verb proposals at quorum." } ], "guardrails": [ { "$pin": "guardrail.stateless-worker-no-rival-authority" }, { "$pin": "guardrail.deterministic-before-nondeterministic-budget" } ], "tool": { "$pin": "tool.constructible-node" }, "worked_example": "Synthetic 10-envelope multi-tier intelligence workload recomputed in test_constructible_node.py: executes point lookup, exact-signature cache short-circuit (0 tokens), <6h keyword-hydrated cohort quantile, negative-exclusion appetite and peer-actor matching (0 excluded leaks), multi-epoch OLS slope, minimal pi harness delegation and 3 repeated unserved cross_shock_elasticity queries in an opencode cell that trigger 1 capability-spinout proposal and accelerate the 4th query to rung_2_typed_code_blocks in 0 tokens, while passing AST and domain-agnostic naming gates." }, "relations": [ [ "requires_noun", "guardrail.stateless-worker-no-rival-authority" ], [ "requires_noun", "guardrail.deterministic-before-nondeterministic-budget" ], [ "requires_noun", "spec.twenty-stage-contract-and-waterfall-rungs" ], [ "requires_noun", "rules.step-reprofile-keyword-pull-and-spinout" ], [ "requires_noun", "tool.constructible-node" ], [ "requires_noun", "template.constructible-node-receipt" ] ] }, { "slug": "guardrail.stateless-worker-no-rival-authority", "category": "noun.skill_pack", "role": "guardrail", "title": "Guardrail: constructible nodes stay stateless workers and never enqueue or self-admit spinout verbs", "category_reason": "Preserves Tessera as sole lease, storage and admission authority while allowing workers to self-construct ephemeral execution pipelines.", "value": { "rule": "Constructible worker nodes claim Tessera verbs, hydrate pinned contracts and emit unserved-capability proposals in proposed_verbs without running an independent scheduler or admitting unverified blocks.", "how_it_is_checked": "CapabilityGapSpinoutLedger emits structured verb proposals only at quorum and requires explicit verification before admitting a synthesized block." } }, { "slug": "guardrail.deterministic-before-nondeterministic-budget", "category": "noun.skill_pack", "role": "guardrail", "title": "Guardrail: exact cache, keyword context and typed code blocks execute before model or CLI harness rungs", "category_reason": "Prevents LLM-only token waste on repeatable lookups, cohort statistics, exclusions and already-solved intermediate states.", "value": { "rule": "Unless an envelope explicitly requests minimal_cli_harness_delegate, WeightedWaterfallExecutor probes Rung 0 exact cache, Rung 1 keyword fresh context and Rung 2 typed code blocks before Rung 3 hybrid or Rung 4 CLI harness cells.", "how_it_is_checked": "test_constructible_node.py verifies 5 zero-token executions across cache reuse, cohort quantiles, OLS trends and post-spinout block reuse." } }, { "slug": "spec.twenty-stage-contract-and-waterfall-rungs", "category": "noun.benchmark_suite", "role": "spec", "title": "Specification: 20-stage constructible pipeline, 5 waterfall rungs, CLI harness cells and 5x6 persona matrix", "category_reason": "Defines deterministic contract presets, waterfall rung ordering, CLI harness workspace schemas and multi-dimensional review axes.", "value": { "stage_presets": [ "minimal_cli_harness_delegate", "full_20_stage_frontier_supernode" ], "waterfall_rungs": [ "rung_0_exact_cache", "rung_1_keyword_fresh_context", "rung_2_typed_code_blocks", "rung_3_hybrid_analytical", "rung_4_cli_harness_grid" ], "harness_clis": [ "opencode", "pi", "codex" ], "persona_dimensions": [ "correctness", "latency_score", "cost_efficiency", "token_economy", "safety_compliance", "reusability" ] } }, { "slug": "rules.step-reprofile-keyword-pull-and-spinout", "category": "noun.reflex_procedure", "role": "rules", "title": "Per-step signature profiling, <6h fresh keyword hydration, Plan-K / Decide-1 and spinout quorum rules", "category_reason": "Zero-model cognitive control procedure governing short-circuit cache hits, fresh external context hydration, strategy placement and background capability synthesis.", "value": { "exact_short_circuit": "Canonical SHA-256 over intent_kind, entity_id, cohort_id, normalized query_text and sorted negative_tags returns cached verified output at Rung 0 in 0 tokens.", "fresh_keyword_hydration": "Keyword matches on resources updated within fresh_resource_max_age_hours (6.0h) inject live calibration multipliers prior to block execution.", "frontier_strategies": [ "reuse", "compose", "modify", "build_new" ], "spinout_rule": "When an unserved shape_hash reaches capability_spinout_quorum (3), emit a proposed builder verb to synthesize a reusable Rung 2 deterministic block.", "model_calls": 0 } }, { "slug": "tool.constructible-node", "category": "noun.code_node", "role": "tool_card", "title": "Tool card: standard-library WeightedWaterfallExecutor, ContinuousStepProfiler, MultiPersonaVectorJudge and CapabilityGapSpinoutLedger", "category_reason": "Tested Python 3.10+ standard-library package pinned by path and SHA-256.", "value": { "name": "self-constructing node and waterfall", "code": { "$code": "self-constructing-node-and-waterfall" }, "runtime": "Python 3.10 or later, standard library only.", "commands": [ "python -m constructible_node --bundle BUNDLE.json" ], "does": [ "Hydrates minimal 6-stage CLI-harness delegates or full 20-stage constructible pipelines with 5W1H interrogation and per-step state profiling.", "Executes five weighted waterfall rungs across exact cache, <6h keyword hydration, typed analytical blocks, hybrid synthesis and opencode/pi/codex harness cells.", "Scores outputs across 5 stakeholder personas x 6 dimensions, proposes cheaper distillations, emits quorum spinout proposals and enforces AST/domain-agnostic gates." ], "does_not": [ "Create an independent scheduler or admission authority, leak excluded negative tags or execute untrusted network code." ], "code_license": "MIT" }, "relations": [ [ "verifies", "spec.twenty-stage-contract-and-waterfall-rungs" ] ] }, { "slug": "template.constructible-node-receipt", "category": "noun.scene_recipe", "role": "template", "title": "Template: constructible node waterfall execution, persona vector evaluation and spinout acceleration receipt", "value": { "describes": "a deterministic receipt of envelope waterfall execution, zero-token and cache short-circuit counts, fresh resource hydrations, negative-tag leak checks, capability spinout proposals and AST/naming gate checks", "schema": { "type": "object", "additionalProperties": false, "required": [ "total_envelopes_executed", "zero_token_executions", "cache_short_circuits", "fresh_resource_hydrations", "excluded_tag_leaks", "spinout_verbs_proposed", "post_spinout_rung", "post_spinout_tokens", "all_persona_panels_passed", "engine_ast_violations", "sample_magic_ast_violations", "sample_domain_naming_violations" ], "properties": { "total_envelopes_executed": { "type": "integer", "minimum": 1 }, "zero_token_executions": { "type": "integer", "minimum": 0 }, "cache_short_circuits": { "type": "integer", "minimum": 0 }, "fresh_resource_hydrations": { "type": "integer", "minimum": 0 }, "excluded_tag_leaks": { "type": "integer", "minimum": 0 }, "spinout_verbs_proposed": { "type": "integer", "minimum": 0 }, "post_spinout_rung": { "type": "string" }, "post_spinout_tokens": { "type": "integer", "minimum": 0 }, "all_persona_panels_passed": { "type": "boolean" }, "engine_ast_violations": { "type": "integer", "minimum": 0 }, "sample_magic_ast_violations": { "type": "integer", "minimum": 0 }, "sample_domain_naming_violations": { "type": "integer", "minimum": 0 } } }, "example": { "total_envelopes_executed": 10, "zero_token_executions": 5, "cache_short_circuits": 1, "fresh_resource_hydrations": 2, "excluded_tag_leaks": 0, "spinout_verbs_proposed": 1, "post_spinout_rung": "rung_2_typed_code_blocks", "post_spinout_tokens": 0, "all_persona_panels_passed": true, "engine_ast_violations": 0, "sample_magic_ast_violations": 1, "sample_domain_naming_violations": 1 } } }, { "slug": "example.constructible-node-bundle", "category": "noun.eval_run", "role": "example", "synthetic": true, "title": "Worked example input: synthetic 10-envelope entity, cohort, appetite-exclusion, trend and unserved spinout bundle", "category_reason": "Synthetic fixture recomputed by test_constructible_node.py.", "value": { "substrate": { "entities": [ { "entity_id": "ENT-101", "cohort_id": "COHORT-COASTAL", "hazard_index": 0.42, "feature_vector": [ 0.9, 0.2, 0.8 ], "tags": [ "resilient_roof", "elevated_grade" ] }, { "entity_id": "ENT-102", "cohort_id": "COHORT-COASTAL", "hazard_index": 0.78, "feature_vector": [ 0.85, 0.3, 0.75 ], "tags": [ "floodway_adjacent", "unreinforced_frame" ] }, { "entity_id": "ENT-103", "cohort_id": "COHORT-COASTAL", "hazard_index": 0.31, "feature_vector": [ 0.88, 0.25, 0.82 ], "tags": [ "resilient_roof", "solar_ready" ] } ], "actors": [ { "actor_id": "ACT-A1", "tags": [ "coastal_specialist", "resilient_roof" ] }, { "actor_id": "ACT-A2", "tags": [ "floodway_adjacent" ] } ], "series": { "ENT-101": [ 1.1, 1.25, 1.4, 1.55 ] } }, "envelopes": [ { "actor_id": "ACT-REQ-1", "intent_kind": "point_lookup", "entity_id": "ENT-101", "query_text": "Return verified baseline attributes for ENT-101", "operating_preset": "full_20_stage_frontier_supernode" }, { "actor_id": "ACT-REQ-2", "intent_kind": "point_lookup", "entity_id": "ENT-101", "query_text": "Return verified baseline attributes for ENT-101", "operating_preset": "full_20_stage_frontier_supernode" }, { "actor_id": "ACT-REQ-1", "intent_kind": "cohort_percentile", "entity_id": "ENT-101", "query_text": "Compare hazard cohort percentile with updated drift feed", "operating_preset": "full_20_stage_frontier_supernode" }, { "actor_id": "ACT-REQ-1", "intent_kind": "appetite_exclusion_match", "cohort_id": "COHORT-COASTAL", "appetite_vector": [ 0.9, 0.2, 0.8 ], "negative_tags": [ "floodway_adjacent" ], "query_text": "Match appetite entities and peer actors excluding floodway_adjacent", "operating_preset": "full_20_stage_frontier_supernode", "require_narrative_synthesis": true }, { "actor_id": "ACT-REQ-1", "intent_kind": "ols_trend", "entity_id": "ENT-101", "temporal_horizon": "multi_epoch_series", "query_text": "Compute longitudinal trajectory slope for ENT-101", "operating_preset": "full_20_stage_frontier_supernode" }, { "actor_id": "ACT-REQ-3", "intent_kind": "ad_hoc_summary", "entity_id": "ENT-103", "query_text": "Delegate simple summary to pi harness cell", "operating_preset": "minimal_cli_harness_delegate", "harness_cell": "pi_fast_delegator" }, { "actor_id": "ACT-REQ-4", "intent_kind": "cross_shock_elasticity", "entity_id": "ENT-101", "query_text": "Compute unserved cross-shock elasticity metric", "operating_preset": "full_20_stage_frontier_supernode", "harness_cell": "opencode_structured_builder" }, { "actor_id": "ACT-REQ-5", "intent_kind": "cross_shock_elasticity", "entity_id": "ENT-102", "query_text": "Compute unserved cross-shock elasticity metric", "operating_preset": "full_20_stage_frontier_supernode", "harness_cell": "opencode_structured_builder" }, { "actor_id": "ACT-REQ-6", "intent_kind": "cross_shock_elasticity", "entity_id": "ENT-103", "query_text": "Compute unserved cross-shock elasticity metric", "operating_preset": "full_20_stage_frontier_supernode", "harness_cell": "opencode_structured_builder" } ], "post_spinout_envelope": { "actor_id": "ACT-REQ-7", "intent_kind": "cross_shock_elasticity", "entity_id": "ENT-102", "query_text": "Compute cross-shock elasticity after spinout block admission", "operating_preset": "full_20_stage_frontier_supernode" }, "auto_admit_verified_spinout": true, "magic_code_sample": "def bad_timeout(x: int) -> int:\n return x + 45\n", "industry_coupled_sample": "class MortgagePipeline:\n pass\n", "shows": "Synthetic 10-envelope multi-tier workload exercising exact cache reuse, <6h keyword hydration, appetite + negative exclusion matching, OLS trend, pi/opencode harness cells and quorum spinout block synthesis.", "source": "Synthetic. Written for this pack." } }, { "slug": "example.constructible-node-receipt", "category": "noun.eval_run", "role": "example", "synthetic": true, "title": "Worked example output: recomputed constructible node waterfall, persona panel and spinout receipt", "category_reason": "Synthetic receipt verified by test_constructible_node.py.", "value": { "conforms_to": { "$pin": "template.constructible-node-receipt" }, "instance": { "total_envelopes_executed": 10, "zero_token_executions": 5, "cache_short_circuits": 1, "fresh_resource_hydrations": 2, "excluded_tag_leaks": 0, "spinout_verbs_proposed": 1, "post_spinout_rung": "rung_2_typed_code_blocks", "post_spinout_tokens": 0, "all_persona_panels_passed": true, "engine_ast_violations": 0, "sample_magic_ast_violations": 1, "sample_domain_naming_violations": 1 }, "shows": "Recomputes exact cache hits, zero-token executions, <6h resource hydrations, zero negative-tag leaks, quorum spinout acceleration and AST/naming gate checks.", "source": "Synthetic. Recomputed directly from example.constructible-node-bundle." }, "relations": [ [ "derives_from", "example.constructible-node-bundle" ], [ "verifies", "template.constructible-node-receipt" ] ] } ], "verbs": [ { "slug": "interrogate-and-profile-envelope", "kind": "verb.generate_seed", "title": "Decompose an input envelope across 5W1H plus time, hash step signatures and hydrate <6h keyword resources", "claimant": "agent", "model_use": "none", "summary": "Extract structured who/what/where/when/why/how and temporal horizon fields, compute canonical exact and shape hashes to short-circuit already-solved requests and scan deterministic keywords for recently updated (< 6h) calibration resources.", "outcome": "Profiled envelope state signature, cache hit verdict and hydrated fresh resource list.", "ready_outcome": "envelope_profiled", "pinned": [ "spec.twenty-stage-contract-and-waterfall-rungs", "rules.step-reprofile-keyword-pull-and-spinout", "tool.constructible-node" ], "slots": [ { "name": "envelope_bundle", "category": "noun.eval_run", "description": "Pin of input envelopes, contracts and substrate state." } ], "produces": [ { "name": "profile_stage_receipt", "template": "template.constructible-node-receipt" } ], "steps": [ "Interrogate envelope fields across who, what, where, when, why, how and temporal horizon.", "Compute canonical exact_hash and shape_hash and hydrate matching resources updated within fresh_resource_max_age_hours." ], "acceptance": [ { "id": "deterministic-short-circuit-and-hydration", "check": "ContinuousStepProfiler short-circuits identical envelopes in 0 tokens and KeywordFreshResourceTrigger hydrates <6h resources deterministically.", "method": "deterministic" } ] }, { "slug": "execute-weighted-waterfall-and-harness-grid", "kind": "verb.generate_seed", "title": "Explore Plan-K frontier strategies and execute the lowest-cost waterfall rung or CLI harness cell", "claimant": "agent", "model_use": "none", "summary": "Rank K candidate strategies across reuse, compose, modify and build_new with placement targets, then execute the lowest-cost admissible rung across deterministic blocks, hybrid synthesis or isolated opencode, pi and codex harness cells.", "outcome": "Typed waterfall execution trace with zero-leak negative exclusion enforcement.", "ready_outcome": "waterfall_executed", "pinned": [ "spec.twenty-stage-contract-and-waterfall-rungs", "rules.step-reprofile-keyword-pull-and-spinout", "guardrail.deterministic-before-nondeterministic-budget", "tool.constructible-node" ], "slots": [ { "name": "profiled_envelope_bundle", "category": "noun.eval_run", "description": "Pin of profiled input envelopes and target operating preset." } ], "produces": [ { "name": "waterfall_execution_receipt", "template": "template.constructible-node-receipt" } ], "steps": [ "Score reuse, compose, modify and build_new strategies and assign ephemeral placement targets.", "Execute Rung 0..2 deterministic blocks with strict negative-tag exclusion before falling back to Rung 3 hybrid or Rung 4 CLI harness cells." ], "acceptance": [ { "id": "zero-negative-exclusion-leaks", "check": "WeightedWaterfallExecutor enforces zero excluded_tag_leaks and selects deterministic blocks whenever admitted.", "method": "deterministic" } ], "follows": [ "self-constructing-node-and-waterfall.interrogate-and-profile-envelope" ] }, { "slug": "evaluate-persona-vectors-and-spinout-gap", "kind": "verb.verify_gate", "title": "Score outputs across 5 stakeholder personas x 6 dimensions and emit quorum capability-spinout proposals", "claimant": "agent", "model_use": "none", "summary": "Evaluate waterfall outputs across five stakeholder personas and six vector dimensions, propose cheaper deterministic distillations for high-token runs, emit capability-builder verb proposals when unserved shape hashes hit quorum and verify AST/domain-agnostic gates.", "outcome": "Verified multi-persona vector scorecard, capability spinout receipt and AST/naming gate verdict.", "ready_outcome": "persona_and_spinout_verified", "review": "distinct_reviewer", "pinned": [ "spec.twenty-stage-contract-and-waterfall-rungs", "rules.step-reprofile-keyword-pull-and-spinout", "guardrail.stateless-worker-no-rival-authority", "tool.constructible-node", "template.constructible-node-receipt" ], "slots": [ { "name": "waterfall_trace_bundle", "category": "noun.eval_run", "description": "Pin of waterfall execution traces and source code under conformance audit." } ], "produces": [ { "name": "constructible_node_receipt", "template": "template.constructible-node-receipt" } ], "steps": [ "Compute six-dimensional vector scores across five weighted stakeholder personas and flag cheaper distillation opportunities.", "Emit a proposed synthesis verb when an unserved shape_hash hits quorum and verify zero AST magic-literal or industry-naming violations." ], "acceptance": [ { "id": "persona-spinout-and-ast-conformance", "check": "All persona panels pass, quorum spinout accelerates subsequent envelopes to Rung 2 in 0 tokens and engine AST/naming violations equal 0.", "method": "deterministic" } ], "follows": [ "self-constructing-node-and-waterfall.execute-weighted-waterfall-and-harness-grid" ] } ] }