mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
583 lines
25 KiB
HTML
583 lines
25 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>constraint-rules</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/constraint-rules.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/constraint-rules">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/constraint-rules.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>constraint-rules</h1><p class="lede">Reference guide for constraint propagation rules in typed holes refactoring including dependency tracking and solution space narrowing. Use as reference when propagating constraints between resolved holes.</p><h1>Constraint Propagation Rules</h1>
|
|
<p>Complete guide to constraint propagation in typed holes refactoring.</p>
|
|
<h2>Overview</h2>
|
|
<p>When a hole is resolved, its resolution creates constraints that propagate to dependent holes. This narrows the solution space and discovers new requirements.</p>
|
|
<h2>Propagation Rule Types</h2>
|
|
<h3>1. Interface Resolution → Type Constraints</h3>
|
|
<p><strong>Pattern</strong>: Concrete types flow to consumers</p>
|
|
<p><strong>Rule</strong>:</p>
|
|
<pre><code>IF: Interface hole resolved with type T
|
|
THEN: All consumers must handle type T</code></pre>
|
|
<p><strong>Example 1: Async Interface</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R3_abstraction_layers
|
|
class NodeInterface:
|
|
async def run(self, context: Context) -> Result
|
|
|
|
# Propagates to:
|
|
R4_parallel_execution:
|
|
MUST handle async/await
|
|
MUST use asyncio for concurrency
|
|
|
|
R5_error_handling:
|
|
MUST catch async exceptions
|
|
MUST use try/except with async context
|
|
|
|
R7_testing:
|
|
MUST use pytest-asyncio
|
|
MUST test async behavior</code></pre>
|
|
<p><strong>Example 2: Generic Types</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R2_module_boundaries
|
|
class Repository(Protocol[T]):
|
|
def get(self, id: str) -> T
|
|
def save(self, entity: T) -> None
|
|
|
|
# Propagates to:
|
|
R4_implementations:
|
|
MUST provide type parameter
|
|
MUST implement both methods with consistent T
|
|
|
|
R7_testing:
|
|
MUST test with concrete types
|
|
MUST verify type safety</code></pre>
|
|
<h3>2. Implementation → Performance Constraints</h3>
|
|
<p><strong>Pattern</strong>: Resource usage flows to dependent operations</p>
|
|
<p><strong>Rule</strong>:</p>
|
|
<pre><code>IF: Implementation uses N resources
|
|
THEN: Dependent operations share/compete for N resources</code></pre>
|
|
<p><strong>Example 1: Concurrency Limits</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R4_parallelization
|
|
parallel_executor = {
|
|
"max_concurrent": 3,
|
|
"strategy": "asyncio.gather"
|
|
}
|
|
|
|
# Propagates to:
|
|
R8_rate_limiting:
|
|
rate_limit = provider_limit / 3
|
|
|
|
R9_memory_budget:
|
|
memory_per_operation * 3 < total_memory
|
|
|
|
R10_connection_pool:
|
|
pool_size >= 3
|
|
|
|
R7_testing:
|
|
MUST test with max_concurrent operations
|
|
MUST verify no race conditions</code></pre>
|
|
<p><strong>Example 2: Cache Size</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R5_caching_strategy
|
|
cache = {
|
|
"max_size": 1000,
|
|
"eviction": "LRU",
|
|
"ttl": 3600
|
|
}
|
|
|
|
# Propagates to:
|
|
R9_memory_budget:
|
|
cache_memory = 1000 * avg_entry_size
|
|
total_memory >= cache_memory + operation_memory
|
|
|
|
R4_key_design:
|
|
MUST design keys for good hit rate
|
|
MUST handle cache invalidation
|
|
|
|
R7_testing:
|
|
MUST test cache hit/miss scenarios
|
|
MUST test eviction behavior</code></pre>
|
|
<h3>3. Validation → Test Requirements</h3>
|
|
<p><strong>Pattern</strong>: Test needs flow upstream</p>
|
|
<p><strong>Rule</strong>:</p>
|
|
<pre><code>IF: Validation requires N test cases
|
|
THEN: Test data and metrics must support N cases</code></pre>
|
|
<p><strong>Example 1: Optimization Validation</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R8_optimization_testing
|
|
validation = {
|
|
"required_examples": 50,
|
|
"statistical_significance": 0.05,
|
|
"comparison_metric": "accuracy"
|
|
}
|
|
|
|
# Propagates to:
|
|
R6_test_data:
|
|
MUST collect >= 50 labeled examples
|
|
MUST ensure diversity in examples
|
|
|
|
R7_metrics:
|
|
MUST support batch evaluation
|
|
MUST compute statistical significance
|
|
|
|
R9_infrastructure:
|
|
MUST support running 50+ test cases
|
|
MUST store results for comparison</code></pre>
|
|
<p><strong>Example 2: Performance Testing</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R9_performance_validation
|
|
perf_tests = {
|
|
"required_scenarios": 20,
|
|
"iterations_per_scenario": 100,
|
|
"metrics": ["latency_p50", "latency_p99", "throughput"]
|
|
}
|
|
|
|
# Propagates to:
|
|
R7_test_infrastructure:
|
|
MUST support benchmark harness
|
|
MUST collect timing data
|
|
|
|
R6_test_data:
|
|
MUST have 20 representative scenarios
|
|
|
|
R8_monitoring:
|
|
MUST track same metrics in production</code></pre>
|
|
<h3>4. Dependency Resolution → Implementation Constraints</h3>
|
|
<p><strong>Pattern</strong>: Chosen dependencies constrain implementations</p>
|
|
<p><strong>Rule</strong>:</p>
|
|
<pre><code>IF: Dependency D chosen with version V
|
|
THEN: Implementation must be compatible with D@V</code></pre>
|
|
<p><strong>Example 1: Framework Choice</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R2_testing_framework
|
|
testing = {
|
|
"framework": "pytest",
|
|
"version": "7.4.0",
|
|
"plugins": ["pytest-asyncio", "pytest-cov"]
|
|
}
|
|
|
|
# Propagates to:
|
|
R7_test_writing:
|
|
MUST use pytest fixtures
|
|
MUST use pytest-asyncio for async tests
|
|
|
|
R8_ci_config:
|
|
MUST install pytest 7.4.0
|
|
MUST run pytest command
|
|
|
|
R4_async_implementation:
|
|
CAN use asyncio (pytest-asyncio supports it)</code></pre>
|
|
<p><strong>Example 2: Library Version</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R3_http_client
|
|
http = {
|
|
"library": "httpx",
|
|
"version": "0.24.0",
|
|
"features": ["async", "http2"]
|
|
}
|
|
|
|
# Propagates to:
|
|
R4_api_implementations:
|
|
MUST use httpx.AsyncClient
|
|
CAN use HTTP/2 features
|
|
|
|
R5_error_handling:
|
|
MUST handle httpx exceptions
|
|
MUST handle httpx.TimeoutException
|
|
|
|
R6_testing:
|
|
MUST mock httpx (not requests)
|
|
CAN use httpx.MockTransport</code></pre>
|
|
<h3>5. Architecture → Module Constraints</h3>
|
|
<p><strong>Pattern</strong>: Architecture rules flow to all modules</p>
|
|
<p><strong>Rule</strong>:</p>
|
|
<pre><code>IF: Architecture defines layer L with rules R
|
|
THEN: All modules in L must follow R</code></pre>
|
|
<p><strong>Example 1: Layered Architecture</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R1_target_architecture
|
|
architecture = {
|
|
"layers": ["api", "domain", "data"],
|
|
"rules": {
|
|
"api": {
|
|
"can_import": ["domain"],
|
|
"cannot_import": ["data"]
|
|
},
|
|
"domain": {
|
|
"can_import": [],
|
|
"cannot_import": ["api", "data"]
|
|
},
|
|
"data": {
|
|
"can_import": ["domain"],
|
|
"cannot_import": ["api"]
|
|
}
|
|
}
|
|
}
|
|
|
|
# Propagates to:
|
|
R2_all_modules:
|
|
MUST respect layer import rules
|
|
|
|
R4_new_modules:
|
|
MUST be assigned to a layer
|
|
MUST follow that layer's rules
|
|
|
|
R7_testing:
|
|
MUST test layer violation detection
|
|
test_no_layer_violations()</code></pre>
|
|
<p><strong>Example 2: Dependency Direction</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R1_dependency_flow
|
|
flow = {
|
|
"direction": "top-down",
|
|
"rule": "Higher layers depend on lower, never reverse"
|
|
}
|
|
|
|
# Propagates to:
|
|
R4_all_implementations:
|
|
abstractions in lower layers
|
|
implementations in higher layers
|
|
|
|
R5_interfaces:
|
|
defined in lower layers
|
|
consumed by higher layers</code></pre>
|
|
<h2>Constraint Discovery</h2>
|
|
<p>Sometimes resolving a hole discovers NEW constraints:</p>
|
|
<p><strong>Example: Discovering Resource Limits</strong></p>
|
|
<pre><code class="lang-python"># Resolution of R4_parallelization
|
|
# Attempts max_concurrent=10
|
|
|
|
# During testing, discovers:
|
|
- Provider rate limit = 30 req/min
|
|
- Memory per operation = 500MB
|
|
- Total memory = 4GB
|
|
|
|
# This DISCOVERS new constraints:
|
|
R4_updated:
|
|
max_concurrent <= min(
|
|
30 / requests_per_operation, # Rate limit
|
|
4000 / 500, # Memory limit (=8)
|
|
10 # Desired
|
|
) = 8
|
|
|
|
# And PROPAGATES:
|
|
R8_rate_limiting:
|
|
MUST implement backoff for rate limits
|
|
|
|
R9_memory_management:
|
|
MUST monitor memory usage
|
|
MUST fail fast if memory exceeded</code></pre>
|
|
<h2>Contradiction Detection</h2>
|
|
<p>If constraints contradict, stop and resolve:</p>
|
|
<p><strong>Example: Conflicting Requirements</strong></p>
|
|
<pre><code class="lang-python"># R4_performance resolved
|
|
constraint_1 = "latency < 100ms"
|
|
|
|
# R5_security resolved
|
|
constraint_2 = "encrypt all data (adds 150ms overhead)"
|
|
|
|
# CONFLICT DETECTED:
|
|
# Cannot satisfy both constraints simultaneously
|
|
|
|
# Resolution options:
|
|
1. Relax performance: latency < 200ms
|
|
2. Optimize encryption: use hardware acceleration
|
|
3. Parallelize: encrypt async, don't block main path
|
|
4. Compromise: encrypt at rest, not in transit
|
|
|
|
# Document decision in REFACTOR_IR.md</code></pre>
|
|
<h2>Propagation Algorithm</h2>
|
|
<pre><code class="lang-python">def propagate_constraints(resolved_hole, resolution):
|
|
"""Propagate constraints from resolved hole to dependents"""
|
|
|
|
# 1. Extract constraints from resolution
|
|
new_constraints = extract_constraints(resolution)
|
|
|
|
# 2. Find dependent holes
|
|
dependents = get_dependent_holes(resolved_hole)
|
|
|
|
# 3. For each dependent
|
|
for dependent in dependents:
|
|
# Apply each propagation rule
|
|
for constraint in new_constraints:
|
|
rule = match_propagation_rule(constraint, dependent)
|
|
if rule:
|
|
# Add constraint to dependent
|
|
dependent.constraints.add(
|
|
apply_rule(rule, constraint)
|
|
)
|
|
|
|
# Narrow solution space
|
|
dependent.solution_space = filter(
|
|
dependent.solution_space,
|
|
lambda s: satisfies(s, constraint)
|
|
)
|
|
|
|
# Check if dependent is now over-constrained
|
|
if is_unsatisfiable(dependent):
|
|
raise ContradictionError(dependent, new_constraints)
|
|
|
|
# Update dependent documentation
|
|
update_refactor_ir(dependent)
|
|
|
|
# 4. Check for newly resolvable holes
|
|
newly_ready = find_ready_holes()
|
|
return newly_ready</code></pre>
|
|
<h2>Practical Examples</h2>
|
|
<h3>Full Propagation Chain</h3>
|
|
<pre><code class="lang-python"># Resolve R1: target_architecture
|
|
resolution_R1 = {
|
|
"layers": ["api", "domain", "infrastructure"],
|
|
"principle": "dependency inversion"
|
|
}
|
|
|
|
# Propagates to R2: module_boundaries
|
|
constraint_R2 = "domain must not depend on infrastructure"
|
|
|
|
# Resolve R2: module_boundaries
|
|
resolution_R2 = {
|
|
"domain": ["core", "services", "interfaces"],
|
|
"infrastructure": ["repositories", "external_apis"]
|
|
}
|
|
|
|
# Propagates to R3: abstraction_layers
|
|
constraint_R3 = "domain defines repository interfaces"
|
|
|
|
# Resolve R3: abstraction_layers
|
|
resolution_R3 = {
|
|
"RepositoryProtocol": "defined in domain/interfaces"
|
|
}
|
|
|
|
# Propagates to R4: implementations
|
|
constraint_R4 = "infrastructure implements RepositoryProtocol"
|
|
|
|
# Resolve R4: implementations
|
|
resolution_R4 = {
|
|
"PostgresRepository": "implements RepositoryProtocol in infrastructure"
|
|
}
|
|
|
|
# Propagates to R7: testing
|
|
constraint_R7 = "test domain with mock repositories"
|
|
|
|
# Full chain:
|
|
R1 → R2 → R3 → R4 → R7</code></pre>
|
|
<h2>Constraint Validation</h2>
|
|
<p>After propagation, validate all constraints:</p>
|
|
<pre><code class="lang-python">def validate_all_constraints():
|
|
"""Check that all constraints are satisfiable"""
|
|
|
|
for hole in all_holes:
|
|
# Check local constraint satisfaction
|
|
if not are_satisfiable(hole.constraints):
|
|
raise ContradictionError(hole)
|
|
|
|
# Check global constraint interaction
|
|
for other_hole in all_holes:
|
|
if conflicts(hole.constraints, other_hole.constraints):
|
|
raise GlobalContradictionError(hole, other_hole)
|
|
|
|
return True</code></pre>
|
|
<hr>
|
|
<h2>Summary</h2>
|
|
<p>Constraint propagation is the heart of typed holes refactoring:</p>
|
|
<ol><li><strong>Extract</strong> constraints from each resolution</li><li><strong>Propagate</strong> to dependent holes via rules</li><li><strong>Narrow</strong> solution spaces</li><li><strong>Discover</strong> new constraints</li><li><strong>Detect</strong> contradictions early</li><li><strong>Validate</strong> continuously</li></ol>
|
|
<p>This ensures that each hole resolution is informed by all previous decisions, maintaining global consistency throughout the refactoring process.</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/constraint-rules.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |