packlight-cli 0.0.0-stage → 0.1.1

package/dist/report/styles.js

@@ -0,0 +1,202 @@
+// Report styles: tokens and type from design DR10, layout from DR2/DR4/DR11. Native fonts only (the CSP blocks downloads).
+export const STYLES = String.raw `
+:root {
+  --bg: #ffffff; --bg-2: #f6f7f8; --ink: #111318; --ink-2: #535b67; --ink-3: #9aa1ab; --line: #e6e8eb; --accent: #111318; --on-accent: #ffffff;
+  --seg-1: #27272a; --seg-2: #8a8f98; --seg-3: #c2833a; --seg-4: #cfd2d7; --seg-5: #5b6b8c;
+  --green: #15803d; --green-soft: #e9f7ee; --amber: #b45309; --amber-soft: #fff4e0; --red: #b91c1c; --red-soft: #fdecec;
+  --font: -apple-system, BlinkMacSystemFont, "SF Pro Text", "Segoe UI Variable Text", "Segoe UI", system-ui, sans-serif;
+  --mono: ui-monospace, "SF Mono", "Cascadia Mono", Menlo, Consolas, monospace;
+  color-scheme: light dark;
+}
+@media (prefers-color-scheme: dark) {
+  :root {
+    --bg: #121317; --bg-2: #1a1c21; --ink: #eef0f3; --ink-2: #aab1bc; --ink-3: #6b7280; --line: #262a31; --accent: #eef0f3; --on-accent: #121317;
+    --seg-1: #e4e4e7; --seg-2: #8b919c; --seg-3: #d9993f; --seg-4: #4a4f58; --seg-5: #8fa3c9;
+    --green: #34d070; --green-soft: #13261b; --amber: #f5b14b; --amber-soft: #2e2414; --red: #f87171; --red-soft: #2f1a1a;
+  }
+}
+@media (prefers-contrast: more) { :root { --ink-2: var(--ink); --line: var(--ink-3); } }
+* { box-sizing: border-box; }
+html { -webkit-text-size-adjust: 100%; }
+body { margin: 0; background: var(--bg); color: var(--ink); font: 14px/1.45 var(--font); font-optical-sizing: auto; -webkit-font-smoothing: antialiased; accent-color: var(--accent); caret-color: var(--accent); scrollbar-color: var(--ink-3) transparent; }
+::selection { background: var(--red-soft); color: var(--ink); }
+:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; border-radius: 4px; }
+button { font: inherit; color: inherit; background: none; border: 0; padding: 0; cursor: pointer; }
+button:disabled { cursor: default; opacity: .5; }
+code, .mono { font-family: var(--mono); font-size: 12.5px; }
+h1, h2, h3, p { margin: 0; }
+/* No orphans: headings balance their lines, prose never ends on a single word. */
+h1, h2, h3 { text-wrap: balance; } p, li, dd { text-wrap: pretty; }
+.num { font-variant-numeric: tabular-nums; }
+.muted { color: var(--ink-2); }
+.sr { position: absolute; width: 1px; height: 1px; overflow: hidden; clip: rect(0 0 0 0); white-space: nowrap; }
+a { color: inherit; text-underline-offset: .15em; } a:visited { color: var(--ink-2); }
+
+.wrap { max-width: 1200px; margin: 0 auto; padding: 0 24px; }
+header.mast { border-bottom: 1px solid var(--line); }
+.mast .wrap { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 16px; padding-top: 14px; padding-bottom: 14px; }
+.brand { display: inline-flex; align-items: center; gap: 8px; font-weight: 650; font-size: 17px; letter-spacing: -0.02em; }
+.brand svg { width: 28px; height: 28px; }
+.mast .meta { display: flex; flex-wrap: wrap; align-items: center; gap: 6px 14px; color: var(--ink-2); font-size: 14px; }
+.mast select { font: inherit; color: var(--ink); background: var(--bg); border: 1px solid var(--line); border-radius: 6px; padding: 4px 8px; max-width: 60vw; }
+nav.tabs { border-bottom: 1px solid var(--line); }
+nav.tabs .wrap { display: flex; gap: 4px; overflow-x: auto; scrollbar-width: none; }
+nav.tabs .wrap::-webkit-scrollbar { display: none; }
+[role="tab"] { padding: 12px 12px 10px; border-bottom: 2px solid transparent; color: var(--ink-2); white-space: nowrap; font-weight: 500; }
+[role="tab"][aria-selected="true"] { color: var(--ink); border-bottom-color: var(--ink); }
+main .wrap { padding-top: 28px; padding-bottom: 48px; }
+footer.foot { border-top: 1px solid var(--line); color: var(--ink-2); font-size: 13px; }
+footer.foot .wrap { display: flex; flex-wrap: wrap; gap: 4px 18px; padding-top: 16px; padding-bottom: 120px; }
+footer.foot a:visited { color: var(--ink-2); }
+.panel-title { font-size: 22px; font-weight: 600; letter-spacing: -0.01em; margin: 8px 0 6px; }
+.lede { color: var(--ink-2); font-size: 16px; max-width: 70ch; margin-bottom: 20px; }
+
+.banner { border: 1px solid var(--line); background: var(--bg-2); border-radius: 8px; padding: 12px 14px; margin-bottom: 16px; font-size: 16px; display: flex; flex-wrap: wrap; gap: 8px 12px; align-items: center; }
+.banner.warn { border-color: var(--amber); }
+.context { color: var(--ink-2); font-size: 14px; display: flex; flex-wrap: wrap; gap: 4px 12px; }
+.linkish { text-decoration: underline; text-underline-offset: .15em; color: var(--ink-2); }
+
+.hero { padding: 8px 0 28px; border-bottom: 1px solid var(--line); }
+.hero h1 { font-size: 30px; line-height: 1.15; font-weight: 650; letter-spacing: -0.02em; margin: 10px 0 14px; max-width: 30ch; }
+.budget { position: relative; height: 22px; border-radius: 6px; background: var(--bg-2); overflow: hidden; display: flex; border: 1px solid var(--line); }
+.budget .listed { background: var(--ink); }
+.budget .dropped { background: repeating-linear-gradient(135deg, var(--red) 0 4px, var(--red-soft) 4px 8px); }
+.budget .edge { position: absolute; top: -4px; bottom: -4px; width: 2px; background: var(--ink); }
+.budget-legend { display: flex; justify-content: space-between; gap: 8px; color: var(--ink-2); font-size: 13px; margin-top: 6px; }
+.hero-line { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 16px; margin-top: 14px; font-size: 16px; }
+.hero-line b { font-weight: 600; }
+.btn { display: inline-flex; align-items: center; gap: 6px; min-height: 36px; padding: 0 14px; border-radius: 6px; border: 1px solid var(--line); background: var(--bg); font-weight: 500; white-space: nowrap; }
+.btn:hover:not(:disabled) { background: var(--bg-2); }
+.btn.primary { background: var(--accent); color: var(--on-accent); border-color: var(--accent); }
+.btn.primary:hover:not(:disabled) { background: var(--accent); opacity: .86; }
+.btn.small { min-height: 30px; padding: 0 10px; font-size: 13px; }
+.strip { display: flex; flex-wrap: wrap; gap: 4px 18px; padding: 14px 0; border-bottom: 1px solid var(--line); color: var(--ink-2); }
+.strip b { color: var(--ink); font-weight: 600; }
+
+.hero h1 + .loadbar { margin-top: 4px; }
+.loadbar { display: flex; height: 14px; border-radius: 4px; overflow: hidden; background: var(--bg-2); gap: 2px; }
+.loadbar .seg { display: block; min-width: 3px; }
+.loadbar { position: relative; }
+.loadbar .save { position: absolute; right: 0; top: 0; bottom: 0; background: repeating-linear-gradient(135deg, var(--bg) 0 3px, transparent 3px 6px); box-shadow: inset 2px 0 0 var(--green); }
+.legend .sw.save { background: repeating-linear-gradient(135deg, var(--green) 0 2px, transparent 2px 4px); border: 1px solid var(--green); }
+.legend-item.static { cursor: default; }
+.legend-item.static:hover { background: none; color: var(--ink-2); }
+.seg-agents { background: var(--seg-5); } .seg-agentsmd { background: var(--seg-5); } .seg-plugins { background: var(--seg-3); } .seg-base { background: var(--seg-4); }
+.measured { color: var(--ink-2); font-size: 13px; margin-top: 4px; }
+.seg-mcp { background: var(--seg-1); } .seg-skills { background: var(--seg-2); } .seg-hooks { background: var(--seg-3); } .seg-instr { background: var(--seg-4); }
+.legend { display: flex; flex-wrap: wrap; gap: 2px 6px; margin: 8px 0 0 -8px; }
+.legend-item { display: inline-flex; align-items: center; gap: 6px; padding: 4px 8px; border-radius: 6px; color: var(--ink-2); }
+.legend-item:hover { background: var(--bg-2); color: var(--ink); }
+.legend-item b { color: var(--ink); font-weight: 600; }
+.legend .sw { width: 10px; height: 10px; border-radius: 2px; }
+.fix { border: 1px solid var(--line); border-radius: 8px; margin-top: 20px; background: var(--bg-2); }
+.fix-row { display: flex; flex-wrap: wrap; gap: 10px 20px; align-items: center; justify-content: space-between; padding: 10px 10px 10px 16px; }
+.fix-row p { flex: 1 1 280px; }
+.fix-row b { font-weight: 600; }
+.fix-run { padding: 4px 16px 16px; border-top: 1px solid var(--line); display: grid; gap: 8px; justify-items: start; }
+.fix-run > p:first-child { margin-top: 12px; }
+.fix-run .codebox { width: 100%; background: var(--bg); }
+.byhand { display: grid; gap: 6px; margin-top: 6px; color: var(--ink-2); }
+.byhand p { overflow-wrap: anywhere; }
+.byhand b { color: var(--ink); font-weight: 600; }
+.browse { display: grid; grid-template-columns: 200px minmax(0, 1fr); gap: 0 36px; align-items: start; padding-top: 24px; }
+nav.kinds { position: sticky; top: 16px; display: grid; gap: 2px; }
+.kind { display: grid; grid-template-columns: 1fr auto; align-items: baseline; gap: 0 8px; text-align: left; padding: 8px 10px; border-radius: 6px; color: var(--ink-2); border-left: 2px solid transparent; }
+.kind:hover { background: var(--bg-2); color: var(--ink); }
+.kind[aria-pressed="true"] { background: var(--bg-2); color: var(--ink); font-weight: 600; border-left-color: var(--ink); border-radius: 0 6px 6px 0; }
+.kind .kn { font-size: 13px; color: var(--ink-2); font-weight: 500; }
+.kind .ks { grid-column: 1 / -1; font-size: 12px; color: var(--red); font-weight: 500; }
+.kindhead { padding-bottom: 4px; }
+.kindhead h2 { font-size: 24px; font-weight: 650; letter-spacing: -0.02em; display: flex; align-items: baseline; gap: 10px; }
+.kindhead .kc { font-size: 15px; font-weight: 500; color: var(--ink-2); }
+.kinddesc { color: var(--ink-2); max-width: 70ch; margin-top: 4px; }
+.kindstats { display: flex; flex-wrap: wrap; gap: 4px 18px; margin-top: 10px; color: var(--ink-2); }
+.kindstats b { color: var(--ink); font-weight: 600; }
+.filters { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; padding: 16px 0 12px; }
+.chips { display: flex; flex-wrap: wrap; gap: 6px; }
+.chip { border: 1px solid var(--line); border-radius: 6px; padding: 5px 10px; font-size: 13px; color: var(--ink-2); }
+.chip[aria-pressed="true"] { background: var(--ink); color: var(--bg); border-color: var(--ink); }
+.search { flex: 1 1 220px; max-width: 360px; height: 36px; border: 1px solid var(--line); border-radius: 6px; padding: 0 10px; font: inherit; color: var(--ink); background: var(--bg); }
+.sortsel { height: 36px; border: 1px solid var(--line); border-radius: 6px; padding: 0 8px; font: inherit; color: var(--ink); background: var(--bg); }
+.countline { width: 100%; display: flex; gap: 12px; align-items: center; color: var(--ink-2); font-size: 13px; }
+.filters-toggle { display: none; }
+
+table.items { width: 100%; border-collapse: collapse; }
+.items th { text-align: left; font-size: 13px; font-weight: 500; color: var(--ink-2); padding: 8px 10px; border-bottom: 1px solid var(--line); white-space: nowrap; }
+.items th.r, .items td.r { text-align: right; white-space: nowrap; }
+.items td { padding: 10px; border-bottom: 1px solid var(--line); vertical-align: middle; }
+.items td.name { width: 100%; min-width: 180px; }
+.items .nm { font-weight: 500; overflow-wrap: break-word; }
+.items .sub { color: var(--ink-2); font-size: 13px; overflow-wrap: anywhere; }
+.items .unit { display: block; color: var(--ink-2); font-size: 12px; }
+.items tr.marked-archive td { background: var(--red-soft); }
+.items tr.detail td { background: var(--bg-2); padding: 14px 16px 16px 48px; font-size: 14px; }
+.detail dl { display: grid; grid-template-columns: max-content 1fr; gap: 6px 16px; margin: 0; max-width: 100ch; }
+.detail dt { color: var(--ink-2); }
+.detail dd { margin: 0; overflow-wrap: anywhere; }
+.disclose { width: 28px; height: 28px; border-radius: 6px; display: inline-grid; place-items: center; color: var(--ink-2); }
+.disclose svg { width: 12px; height: 12px; transition: transform 120ms ease-out; }
+[aria-expanded="true"] > svg { transform: rotate(90deg); }
+.seg { display: inline-flex; border: 1px solid var(--line); border-radius: 6px; overflow: hidden; }
+.seg button { padding: 4px 8px; font-size: 12.5px; font-weight: 500; color: var(--ink-2); min-height: 28px; }
+.seg button + button { border-left: 1px solid var(--line); }
+.seg button[aria-pressed="true"].a { background: var(--red); color: #fff; }
+.seg button[aria-pressed="true"].k { background: var(--green); color: #fff; }
+.tag { display: inline-block; border-radius: 4px; padding: 0 6px; font-size: 12px; font-weight: 500; background: var(--bg-2); color: var(--ink-2); margin-left: 6px; white-space: nowrap; }
+.tag.red { background: var(--red-soft); color: var(--red); } .tag.green { background: var(--green-soft); color: var(--green); } .tag.amber { background: var(--amber-soft); color: var(--amber); }
+.narrow-meta { display: none; overflow-wrap: anywhere; }
+.impact { background: var(--bg-2); border: 1px solid var(--line); border-radius: 6px; padding: 10px 12px; margin-top: 8px; display: flex; flex-wrap: wrap; gap: 8px; align-items: center; }
+
+.group { border-top: 1px solid var(--line); padding: 14px 0; }
+.group h2 { font-size: 16px; font-weight: 600; margin-bottom: 6px; }
+.group ul { margin: 0; padding-left: 18px; display: grid; gap: 4px; }
+.codebox { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; background: var(--bg-2); border: 1px solid var(--line); border-radius: 8px; padding: 10px 12px; margin: 6px 0; }
+.codebox code { flex: 1 1 240px; overflow-wrap: anywhere; }
+.next { border: 1px solid var(--ink); border-radius: 8px; padding: 14px 16px; margin: 16px 0; font-size: 16px; }
+.next ol { margin: 8px 0 0; padding-left: 20px; display: grid; gap: 6px; }
+textarea.picksjson { width: 100%; min-height: 120px; font: 12.5px var(--mono); }
+.finding { border-top: 1px solid var(--line); padding: 14px 0; display: grid; grid-template-columns: 12px 1fr; gap: 4px 12px; }
+.finding i { width: 8px; height: 8px; border-radius: 50%; margin-top: 7px; background: var(--amber); }
+.finding.high i { background: var(--red); } .finding.good i { background: var(--green); }
+.finding h2 { font-size: 16px; font-weight: 600; } .finding p { grid-column: 2; color: var(--ink-2); max-width: 80ch; }
+
+.picksbar { position: fixed; left: 0; right: 0; bottom: 0; background: var(--bg); border-top: 1px solid var(--line); box-shadow: 0 2px 8px rgba(0,0,0,.12); padding: 10px 24px calc(10px + env(safe-area-inset-bottom, 0px)); display: flex; align-items: center; gap: 12px; z-index: 5; }
+.picksbar[hidden] { display: none; }
+.picksbar .count { font-weight: 600; }
+@media (prefers-reduced-motion: reduce) { .disclose svg { transition: none; } }
+
+/* A narrower sidebar just above the breakpoint, so wide system fonts (Linux, Windows) still fit the table. */
+@media (max-width: 1279px) { .browse { grid-template-columns: 168px minmax(0, 1fr); gap: 0 24px; } .items td.name { min-width: 150px; } }
+/* With the sidebar open, the source column goes first: the source already sits under each name. */
+@media (max-width: 1399px) { .col-source { display: none; } }
+@media (max-width: 1099px) { .col-source, .col-last { display: none; } .items td.name { min-width: 140px; } .items td, .items th { padding-left: 7px; padding-right: 7px; } }
+@media (max-width: 1099px) {
+  .browse { display: block; padding-top: 16px; }
+  nav.kinds { position: static; display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 18px; }
+  .kind { display: inline-flex; gap: 6px; padding: 5px 10px; border: 1px solid var(--line); border-radius: 6px; font-size: 13px; }
+  .kind[aria-pressed="true"] { background: var(--ink); color: var(--bg); border-color: var(--ink); border-radius: 6px; font-weight: 500; }
+  .kind[aria-pressed="true"] .kn { color: inherit; }
+  .kind .ks { display: none; }
+  .kindhead h2 { font-size: 20px; }
+}
+@media (max-width: 719px) {
+  .wrap { padding: 0 16px; }
+  .hero h1 { font-size: 24px; }
+  .filters .more { display: none; width: 100%; }
+  body.filters-open .filters .more { display: flex; flex-wrap: wrap; gap: 8px; }
+  .filters-toggle { display: inline-flex; }
+  .items thead { display: none; }
+  .items .col-2nd { display: none; }
+  .items td.name { min-width: 0; }
+  .items .nm { overflow-wrap: anywhere; }
+  .items .tag { white-space: normal; margin-left: 0; }
+  .items td { word-break: normal; }
+  .narrow-meta { display: block; color: var(--ink-2); font-size: 13px; }
+  .items td { padding: 10px 6px; }
+  .items tr.detail td { padding-left: 12px; }
+  .btn, .chip, .kind, .legend-item, .seg button, .disclose, [role="tab"], .search, .sortsel { min-height: 44px; }
+  .disclose { width: 44px; }
+  footer.foot .wrap { padding-bottom: 140px; }
+  .picksbar { padding-left: 16px; padding-right: 16px; }
+}
+`;

package/dist/report/suggest.d.ts

@@ -0,0 +1,39 @@
+import type { Inventory } from '../core/types.js';
+/** Thresholds printed beside the suggestion button (design DR6). */
+export declare const MIN_SESSIONS = 20;
+export declare const MIN_DAYS = 14;
+export type NotSuggested = 'used' | 'too-new' | 'too-few-sessions' | 'ambiguous' | 'uncertain' | 'parse-gaps' | 'manual' | 'kept' | 'off' | 'plugin-in-use' | 'not-removable';
+export interface Suggestion {
+    suggested: boolean;
+    reason?: NotSuggested;
+    /** Sessions and days the item could have been used in (design-delta DE5). */
+    windowSessions: number;
+    windowDays: number;
+    /** Unreadable log lines inside the item's window (DE6). */
+    unreadableLines: number;
+}
+/**
+ * Decides, per item, whether the report may suggest archiving it. Usage for global items is counted across
+ * all projects (DE1); the window starts when the item was first seen (DE5); unreadable lines inside the window
+ * block a suggestion (DE6); a plugin child is suggested only when its whole plugin could go (DE7).
+ */
+export declare function suggestions(inv: Inventory, keptIds: Set<string>): Map<string, Suggestion>;
+/** One line of the skill listing, for projecting it after some skills go. */
+export interface ListingEntry {
+    name: string;
+    fullChars: number;
+    nameChars: number;
+    priority: boolean;
+}
+/**
+ * Projects the skill listing Claude Code builds: every name first, then the descriptions of skills it counts as
+ * used (and its own bundled skills), then the rest in listing order, each one that still fits under the size cap.
+ * This matches the listings packlight has observed (2.1.29x); it is a projection and always labelled as one.
+ * Self-contained: the report serialises it with Function.toString.
+ */
+export declare function simulateListing(entries: ListingEntry[], budgetChars: number): {
+    chars: number;
+    described: number;
+    dropped: number;
+    describedNames: string[];
+};

package/dist/report/suggest.js

@@ -0,0 +1,88 @@
+/** Thresholds printed beside the suggestion button (design DR6). */
+export const MIN_SESSIONS = 20;
+export const MIN_DAYS = 14;
+const DAY = 86_400_000;
+/**
+ * Decides, per item, whether the report may suggest archiving it. Usage for global items is counted across
+ * all projects (DE1); the window starts when the item was first seen (DE5); unreadable lines inside the window
+ * block a suggestion (DE6); a plugin child is suggested only when its whole plugin could go (DE7).
+ */
+export function suggestions(inv, keptIds) {
+    const scanTime = Date.parse(inv.window.to);
+    const windowFrom = inv.window.from ? Date.parse(inv.window.from) : scanTime;
+    const sessions = inv.sessions.filter(s => s.start);
+    const own = (it) => {
+        const from = Math.max(windowFrom, it.firstSeen ? Date.parse(it.firstSeen) : windowFrom);
+        const inWindow = sessions.filter(s => Date.parse(s.start) >= from && (it.projectRoot === null || s.projectRoot === it.projectRoot));
+        const base = {
+            suggested: false,
+            windowSessions: inWindow.length,
+            windowDays: Math.floor((scanTime - from) / DAY),
+            unreadableLines: inWindow.reduce((n, s) => n + s.unreadableLines, 0),
+        };
+        const no = (reason) => ({ ...base, reason });
+        if (it.kind === 'instructions')
+            return no('not-removable');
+        if (it.removal.method === 'manual')
+            return no('manual');
+        if (it.name === 'packlight' || it.name.endsWith(':packlight'))
+            return no('not-removable');
+        if (!it.enabled)
+            return no('off');
+        if (keptIds.has(it.id))
+            return no('kept');
+        if (it.usage.ambiguous)
+            return no('ambiguous');
+        if (it.usage.uncertain)
+            return no('uncertain');
+        if (it.usage.total > 0)
+            return no('used');
+        if (base.windowDays < MIN_DAYS)
+            return no('too-new');
+        if (base.windowSessions < MIN_SESSIONS)
+            return no('too-few-sessions');
+        if (base.unreadableLines > 0)
+            return no('parse-gaps');
+        return { ...base, suggested: true };
+    };
+    const result = new Map();
+    for (const it of inv.items)
+        result.set(it.id, own(it));
+    // Plugins are judged as a whole (DE7): every part must be eligible on its own, and nothing in it kept.
+    for (const plugin of inv.items.filter(i => i.kind === 'plugin')) {
+        const parts = inv.items.filter(i => i.plugin === plugin.plugin && i.kind !== 'plugin');
+        const self = result.get(plugin.id);
+        const partBlocked = parts.find(p => !result.get(p.id).suggested);
+        const whole = !self.suggested ? self
+            : partBlocked ? { ...self, suggested: false, reason: result.get(partBlocked.id).reason === 'used' ? 'plugin-in-use' : result.get(partBlocked.id).reason }
+                : self;
+        result.set(plugin.id, whole);
+        for (const p of parts) {
+            const mine = result.get(p.id);
+            result.set(p.id, whole.suggested ? mine : { ...mine, suggested: false, reason: mine.suggested ? (whole.reason === 'used' ? 'plugin-in-use' : whole.reason) : mine.reason });
+        }
+    }
+    return result;
+}
+/**
+ * Projects the skill listing Claude Code builds: every name first, then the descriptions of skills it counts as
+ * used (and its own bundled skills), then the rest in listing order, each one that still fits under the size cap.
+ * This matches the listings packlight has observed (2.1.29x); it is a projection and always labelled as one.
+ * Self-contained: the report serialises it with Function.toString.
+ */
+export function simulateListing(entries, budgetChars) {
+    let used = entries.reduce((n, e) => n + e.nameChars, 0);
+    const describedNames = [];
+    for (const pass of [true, false]) {
+        for (const e of entries) {
+            if (e.priority !== pass)
+                continue;
+            const extra = e.fullChars - e.nameChars;
+            if (extra > 0 && used + extra <= budgetChars) {
+                used += extra;
+                describedNames.push(e.name);
+            }
+        }
+    }
+    return { chars: used, described: describedNames.length, dropped: entries.length - describedNames.length, describedNames };
+}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "packlight-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "See what your coding agent carries, keep what you use, archive the rest.",
+  "keywords": [
+    "claude-code",
+    "claude",
+    "mcp",
+    "skills",
+    "hooks",
+    "context",
+    "tokens",
+    "cli",
+    "developer-tools"
+  ],
+  "license": "MIT",
+  "author": "Cooper Kao (https://github.com/cooperism-lab)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cooperism-lab/packlight.git"
+  },
+  "homepage": "https://github.com/cooperism-lab/packlight#readme",
+  "bugs": {
+    "url": "https://github.com/cooperism-lab/packlight/issues"
+  },
+  "type": "module",
+  "bin": {
+    "packlight": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "scan": "node --import tsx src/cli.ts scan",
+    "e2e": "npm run build && playwright test",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "demo": "npm run build && node --import tsx scripts/build-demo.mts"
+  },
+  "devDependencies": {
+    "@axe-core/playwright": "4.13.0",
+    "@playwright/test": "1.64.0",
+    "@types/node": "22.20.5",
+    "@types/write-file-atomic": "4.0.3",
+    "tsx": "4.23.15",
+    "typescript": "5.9.3",
+    "vitest": "3.2.7"
+  },
+  "dependencies": {
+    "write-file-atomic": "6.0.0"
+  }
+}