@shadowclone/cli 0.0.16 → 0.0.18

package/PRIVACY.md

@@ -10,7 +10,7 @@ Shadowclone excludes tool results, tool-returned file contents, thinking blocks,
 
 ## What leaves your machine
 
-Opening the browser editor and using the local MCP server do not send data to Shadowclone. Optional learning, skill drafting, build descriptions, and delegated runs use an agent CLI you choose. Consented, redacted inputs go directly through that provider and are governed by its terms.
+Opening the browser editor and using the local MCP server do not send data to Shadowclone. Optional learning, skill drafting, and build descriptions use an agent CLI you choose. Consented, redacted inputs go directly through that provider and are governed by its terms.
 
 The build description action sends selected skill titles and redacted summaries. It does not send skill bodies, file paths, repository names, or ownership metadata.
 

package/README.md

@@ -34,11 +34,11 @@ Install the CLI:
 npm install -g @shadowclone/cli
 ```
 
-| Step | Command | What happens | Time |
-| --- | --- | --- | ---: |
-| 1 | `shadowclone init` | Answer three questions about learning and skill maintenance | About 1 minute |
-| 2 | `shadowclone learn --deep` | Learn from enabled past sessions; repeat if more history remains | Up to 5 minutes per run |
-| 3 | `shadowclone learning pending` and `shadowclone skills pending` | Review learned rules, scope, and publication before relying on them | About 1 minute |
+| Step | Command                                                         | What happens                                                        |                    Time |
+| ---- | --------------------------------------------------------------- | ------------------------------------------------------------------- | ----------------------: |
+| 1    | `shadowclone init`                                              | Answer three questions about learning and skill maintenance         |          About 1 minute |
+| 2    | `shadowclone learn --deep`                                      | Learn from enabled past sessions; repeat if more history remains    | Up to 5 minutes per run |
+| 3    | `shadowclone learning pending` and `shadowclone skills pending` | Review learned rules, scope, and publication before relying on them |          About 1 minute |
 
 Setup takes about two to three minutes, excluding learning. Deep learning needs an installed and configured `claude`, `codex`, `cursor-agent`, or `pi` CLI. [Pi setup](docs/guides/pi.md) uses any suitable model configured in Pi, including local providers. Claude Code learning on Linux needs `bwrap` and `socat` for its sandbox.
 
@@ -46,22 +46,25 @@ Setup takes about two to three minutes, excluding learning. Deep learning needs
 
 Run `shadowclone` to see the current result and next action. Use `shadowclone wizard` to browse optional workflow skills in a browser.
 
-**Delegate a task.** The optional `shadowclone-work` skill records your standards, acceptance criteria, checks, and review in a private task receipt. It adds work tracking to an existing Claude Code or Codex session. Start with review handoff; shipping actions require explicit repository grants. Native workflow qualification is still pending. [Use delegated work](docs/guides/delegated-work.md).
+**Delegate a pull request.** The optional `shadowclone-work` skill takes a request, an issue, or an existing PR to ready for review: green checks, conflicts resolved, and review comments fixed or left for you. It replies to fixed comments with commit SHAs only and never merges. [Use delegated work](docs/guides/delegated-work.md).
+
+**Use a personal GitHub clone.** Run `shadowclone bot setup` from a repository checkout. Name your App, select its repositories, and review the exact guidance before connecting your Claude subscription. The clone handles owner issues and tagged PR requests. Live installation qualification is pending. [Set up a GitHub clone](docs/guides/github-clones.md).
 
 ## Evaluations
 
-Seven fixed tasks compare four setups using synthetic skills and correction sessions. Scores measure the share of applicable preferences followed in completed sessions, with equal weight per task. Each setup ran three repetitions; one timed-out Luna session is excluded from this view.
+We tested 24 fixed engineering tasks across eight preference families, with three repetitions per setup and model. Scores measure preference adherence, with each family weighted equally.
 
-| Preferences followed | GPT 6.1 Sol, medium | GPT 6 Luna, high | Sonnet 5.5, high | Opus 5.5, medium |
-| --- | ---: | ---: | ---: | ---: |
-| Bare | 96.2% | 97.1% | 59.4% | 52.1% |
-| Existing user skills | 100% | 100% | 65.0% | 63.8% |
-| Skills plus Shadowclone routing | 100% | 100% | 65.0% | 63.8% |
-| Skills, routing, and deep learning | 100% | 100% | 81.7% | 96.4% |
+| Setup                                     | GPT 6.1 Sol | GPT 6 Luna | Claude Sonnet 5.5 | Claude Opus 5.5 |
+| ----------------------------------------- | ----------: | ---------: | ----------------: | --------------: |
+| Agent alone                               |       77.3% |      59.0% |             56.5% |           53.2% |
+| Existing user skills                      |       85.2% |      80.6% |             76.4% |           73.6% |
+| Existing skills + Shadowclone routing     |       86.1% |      72.7% |             76.9% |           75.9% |
+| Existing skills + handwritten preferences |       92.4% |      81.2% |             91.7% |           86.1% |
+| Existing skills + Shadowclone learning    |       89.4% |      83.3% |             90.0% |           82.9% |
 
-Learning added 16.7 percentage points over existing skills on Sonnet and 32.6 on Opus; both 95% bootstrap intervals were above zero. Both Codex models were already at 100% with skills, and routing alone tied skills. All completed tasks passed correctness and safety checks. Luna's existing-skills score covers twenty completed sessions; the other setups cover twenty-one. Its original full-matrix report remains incomplete.
+Shadowclone learning improved recorded adherence over existing skills on all four models. The gain ranges from 2.8 to 13.7 percentage points. Handwritten preferences provide a reference for what agents can follow when the intended rules are supplied directly.
 
-The existing skill contains three preferences; one shared learning run added two from synthetic corrections. These public development tasks show a specific learning benefit, with no claim about other users, repositories, or engineering throughput. [Read the methods, intervals, timeout exclusion, and historical study](evals.md). The [eval guide](docs/guides/fixed-evals.md#how-this-follows-the-claudedev-recommendations) explains which Claude.dev recommendations the benchmark follows and the work still needed for held-out hillclimbing.
+The learning setup includes routing and actual learned preferences from synthetic correction sessions. These results measure preference delivery on this task set. [Read the setup definitions, family scores, methods, and measurement limits](evals.md).
 
 ## Privacy comes first
 
@@ -69,12 +72,12 @@ The existing skill contains three preferences; one shared learning run added two
 
 **You choose what it reads.** Every capture source is off by default and has its own consent setting. Reading sessions does not silently enable memory, repository metadata, or skill editing.
 
-| Operation | What the selected provider can receive |
-| --- | --- |
-| Learning and skill maintenance | Selected redacted instructions, steering, and supporting context |
-| Browser editor | Nothing merely from opening it; optional AI drafting sends reviewed form fields |
-| Delegated `run` | The authorized task worktree and guidance |
-| Evaluation | Synthetic prompts, the tested setup's guidance, and generated code |
+| Operation                      | What the selected provider can receive                                          |
+| ------------------------------ | ------------------------------------------------------------------------------- |
+| Learning and skill maintenance | Selected redacted instructions, steering, and supporting context                |
+| Personal GitHub clone          | The reviewed skills, native rules, selected repository, and issue or PR task    |
+| Browser editor                 | Nothing merely from opening it; optional AI drafting sends reviewed form fields |
+| Evaluation                     | Synthetic prompts, the tested setup's guidance, and generated code              |
 
 **Redaction is a boundary, not an anonymity guarantee.** Tool results, tool-returned file contents, thinking blocks, and data-access results are excluded from learning. Use only sources and repositories you are authorized to send to the selected provider.
 
@@ -82,14 +85,14 @@ The existing skill contains three preferences; one shared learning run added two
 
 ## Guides
 
-| Guide | Use it to |
-| --- | --- |
-| [Agent builds](docs/guides/agent-builds.md) | Choose, create, and equip skills |
-| [Learning](docs/guides/learning.md) | Run deep learning, background learning, or record a preference |
-| [Skill maintenance](docs/guides/skills.md) | Review updates, conflicts, history, and undo |
-| [Repository setup](docs/guides/repositories.md) | Share checks and skills with a repository |
-| [How it works](docs/guides/how-it-works.md) | Follow guidance from consented evidence to coding agents |
-| [Command reference](docs/guides/commands.md) | Find everyday and advanced commands |
+| Guide                                           | Use it to                                                      |
+| ----------------------------------------------- | -------------------------------------------------------------- |
+| [Agent builds](docs/guides/agent-builds.md)     | Choose, create, and equip skills                               |
+| [Learning](docs/guides/learning.md)             | Run deep learning, background learning, or record a preference |
+| [Skill maintenance](docs/guides/skills.md)      | Review updates, conflicts, history, and undo                   |
+| [Repository setup](docs/guides/repositories.md) | Share checks and skills with a repository                      |
+| [How it works](docs/guides/how-it-works.md)     | Follow guidance from consented evidence to coding agents       |
+| [Command reference](docs/guides/commands.md)    | Find everyday and advanced commands                            |
 
 **Further reading:** [Documentation index](docs/README.md) · [Architecture](docs/architecture/README.md) · [Design history](docs/design/README.md) · [Migration](docs/migration.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md)
 

package/dist/_.._/web/client/index.html

@@ -6,7 +6,7 @@
     <meta name="referrer" content="no-referrer" />
     <meta
       http-equiv="Content-Security-Policy"
-      content="default-src 'self'; connect-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' data:; object-src 'none'; base-uri 'none'; form-action 'none'"
+      content="default-src 'self'; connect-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' data:; object-src 'none'; base-uri 'none'; form-action https://github.com"
     />
     <title>Your agent build · Shadowclone</title>
     <link rel="icon" type="image/svg+xml" href="../../../web/shadowclone-mark-w6a76wqy.svg" />
@@ -22,7 +22,8 @@
     
     
     
-  <link rel="stylesheet" crossorigin href="../../../web/index-dzztba9n.css"><script type="module" crossorigin src="../../../web/index-s1e5043w.js"></script></head>
+    
+  <link rel="stylesheet" crossorigin href="../../../web/index-25g5ahxa.css"><script type="module" crossorigin src="../../../web/index-s4mjwgw0.js"></script></head>
   <body>
     <div class="frame">
       <header class="masthead">
@@ -38,8 +39,7 @@
           <p class="eyebrow">YOUR AGENT. YOUR INSTINCTS.</p>
           <h1 id="page-title">Build the way you think.</h1>
           <p class="subtitle">
-            Equip a way of working. Every skill shapes how your agent approaches
-            a task.
+            Equip a way of working. Every skill shapes how your agent approaches a task.
           </p>
         </section>
 
@@ -63,34 +63,33 @@
           <p id="scope-note" class="scope-note"></p>
           <details id="library-note" class="library-note" hidden>
             <summary>Built-in library · add your own</summary>
-            <p>
-              Include your installed skills by choosing the folders Shadowclone
-              can read.
-            </p>
+            <p>Include your installed skills by choosing the folders Shadowclone can read.</p>
             <code>shadowclone skills configure</code>
           </details>
         </div>
         <div id="notice" role="status" class="notice" hidden></div>
         <details class="requirements">
           <summary>Learning model</summary>
-          <p>Models and credentials are configured in your coding harness. Session learning follows that session's model.</p>
+          <p>
+            Models and credentials are configured in your coding harness. Session learning follows
+            that session's model.
+          </p>
           <button id="load-models" class="quiet-button">Refresh available models</button>
-          <label>Saved model <select id="learning-model"><option>Refresh models to choose</option></select></label>
+          <label
+            >Saved model
+            <select id="learning-model">
+              <option>Refresh models to choose</option>
+            </select></label
+          >
         </details>
 
         <div class="workspace">
-          <section
-            id="constellation"
-            class="constellation"
-            aria-label="Skill constellation"
-          >
+          <section id="constellation" class="constellation" aria-label="Skill constellation">
             <div id="constellation-status" class="constellation-status" role="status">
               <p id="constellation-status-text">Loading your skills…</p>
               <button id="retry-build" class="quiet-button" hidden>Retry loading skills</button>
             </div>
             <div class="constellation-controls" aria-label="Constellation controls">
-              <button id="fit-constellation" class="quiet-button">Fit</button>
-              <button id="reset-constellation" class="quiet-button">Reset</button>
               <button
                 id="toggle-constellation-view"
                 class="quiet-button"
@@ -100,22 +99,18 @@
                 Map / list
               </button>
             </div>
-            <svg
-              id="starfield"
-              class="starfield"
-              aria-hidden="true"
-            ></svg>
+            <svg id="starfield" class="starfield" aria-hidden="true"></svg>
             <svg
               id="constellation-map"
               class="constellation-map"
-              aria-label="Skills grouped into navigable hubs"
+              aria-label="Skills grouped by source and category"
             ></svg>
             <div id="constellation-list" class="constellation-list"></div>
-            <p class="tree-hint">Select a category to expand it or a skill to inspect it. Drag to pan and scroll to zoom.</p>
+            <p class="tree-hint">Select a skill to equip it. Search highlights matches.</p>
           </section>
 
           <aside class="build-panel" aria-label="Your character build">
-            <section class="identity" aria-labelledby="identity-title">
+            <section id="identity" class="identity" aria-labelledby="identity-title" aria-live="polite">
               <div>
                 <p class="eyebrow">YOUR BUILD</p>
                 <h2 id="identity-title">An open canvas</h2>
@@ -123,21 +118,17 @@
                   Choose the instincts you want your agent to bring to work.
                 </p>
               </div>
-              <div id="traits" class="traits"></div>
-              <button id="describe" class="quiet-button">
-                Describe my agent with my model
-              </button>
-              <div
-                id="model-description"
-                class="requirements"
-                aria-live="polite"
-              ></div>
+              <ul id="abilities" class="abilities"></ul>
+              <p id="tradeoff" class="tradeoff" hidden></p>
+              <div class="naming-controls">
+                <p id="naming-source" class="naming-source"></p>
+                <button id="retry-name" class="quiet-button" hidden>Retry</button>
+                <button id="toggle-naming" class="quiet-button" aria-pressed="true">
+                  Turn naming off
+                </button>
+              </div>
             </section>
-            <section
-              id="detail"
-              class="detail"
-              aria-label="Selected skill"
-            ></section>
+            <section id="detail" class="detail" aria-label="Selected skill"></section>
           </aside>
         </div>
 
@@ -147,12 +138,6 @@
           hidden
           aria-label="Repository requirements"
         ></section>
-        <details class="requirements">
-          <summary>Work in this repository</summary>
-          <p>Last recorded progress. Inspect a task for current verification and review readiness.</p>
-          <button id="refresh-tasks" class="quiet-button">Refresh recorded work</button>
-          <div id="task-list" aria-live="polite"></div>
-        </details>
       </main>
 
       <footer class="footer">