norn-cli 2.4.0 → 2.6.0

package/.claude/skills/norn-social-campaign/SKILL.md

@@ -1,70 +0,0 @@
----
-name: norn-social-campaign
-description: Continue Peter's Norn LinkedIn social-media campaign — draft/review/schedule posts, reply to engagement, evaluate Week-N kill-criteria, log community signals. Use whenever the user asks about Norn LinkedIn posts, replies, engagement metrics, the GTM experiment, what to post next, or any social/content work for Norn.
----
-
-# Norn Social Media Campaign — Cross-Session Continuity
-
-You are resuming an ongoing GTM experiment Peter has been running for **Norn** (a commercial VS Code extension + CLI he builds solo while employed full-time, UK-based). Most strategic decisions are **locked** — your job is to execute within them, not re-litigate. The canonical state lives in repo `Docs/`; read those before doing real work.
-
-## Read these first (canonical, in this repo)
-
-- `Docs/gtm_plan.md` — **the master plan**. Locked positioning, 13-week kill-criteria with anchored dates, action steps, and an append-only **Progress Log** (scroll to the bottom to see exactly where things stand).
-- `Docs/mot_reaction_series.md` — **the LinkedIn posts** (the filename is misnamed — see Anti-patterns; rename pending).
-- `Docs/linkedin_series.md` — LinkedIn delivery rules (tags, first-comment text, image policy, posting cadence).
-- `Docs/market_signals.md` — append-only community pain-signal intel log. Append; don't re-derive.
-- `Docs/postman_rot_essay.md` (long-form v3) and `Docs/mot_series.md` (v1 micro-posts) — backup bank, not active.
-
-Memory files `norn-gtm-decision.md` and `norn-messaging-locked.md` auto-load and carry the durable decisions.
-
-## What is LOCKED — do not reopen
-
-- **Positioning spine (verbatim, never paraphrase):**
-  > Norn turns API requests into version-controlled tests your whole team can keep — authored and debugged in VS Code, run on every PR in CI.
-  Category = repo-native API regression testing. NOT "REST client", NOT vaguer "workflow automation."
-- **GTM motion:** public commercial launch (PLG + upmarket founder-led semi-sales). 13-week time-boxed experiment. Kill-criteria + anchored dates in `gtm_plan.md`. "CV-asset" is an accepted non-failure outcome.
-- **Sell to:** CTO / founding eng / tech lead at small companies (~≤20–30 people). **QA = evangelist, not buyer.** Eng Manager parked until 50+ people.
-- **Pricing model:** VS Code Extension is **free forever (incl. commercial).** CLI is **free for local use.** **Paid only for CLI Pipeline Use (CI/CD).** No evaluation period. Encoded in `LICENSE` (vsApi + Norn, kept in sync).
-- **Channel: LinkedIn only.** MoT dropped 2026-05-18. One uniform series posted to LinkedIn.
-- **Voice:** dry, specific, recognition-humor, no slang/meme/"touch grass" register, clarity > cleverness, no clever coda after the closing question. ~150–220 words per post.
-- **Canonical ending** (append verbatim, URL-free, to every post):
-  > Disclosure so nobody feels tricked: I build Norn — my attempt at the in-the-repo fix. That's the entire pitch; the post stands without it. Still genuinely curious about the question above, though.
-- **Tags (fixed, every post):** `#API #Testing #DeveloperTools`. Add `#MCP` only on the MCP post. 4 max.
-- **First comment** (within ~1 min of posting):
-  > The Norn bit I mentioned, if you want to poke at it: https://nornapi.com
-- **Posting cadence:** Tue–Thu ~8:30am UK time, one post/day, ≥4–5 days apart.
-- **Visual rule:** real source screenshot (with identifying bits cropped) if a genuine artifact exists; text-only otherwise. **Never** Norn logo. **Never** AI imagery.
-- **Self-presentation:** "QA / automation engineer who builds Norn." **Never "Founder."** The reason is strategic (credibility + disclosure-not-pitch posture), not legal — Peter's employment contract is permissive, employer has long known.
-
-## Anti-patterns — do NOT do
-
-- **Don't reopen the positioning spine.** It was rewritten many times before locking; uniformity *is* the strategy.
-- **Don't suggest pitching Peter's employer.** Internal-champion path was closed 2026-05-18 — declined "prefer not to sour the relationship" (structural/relationship objection, not product, not IP). Their "no" is excluded from any market-signal read.
-- **Don't raise the employer IP-alarm.** Contract permissive; employer long aware; Peter refused a restrictive replacement years ago specifically to protect this. Settled.
-- **Don't suggest MoT / Reddit / forums as a posting channel.** Dropped. LinkedIn only.
-- **Don't pitch Norn in post bodies or in comment replies.** The canonical ending + first comment do all the selling. Replies = host of a conversation, not salesperson.
-- **Don't suggest a separate LinkedIn-native content stream.** One uniform series. Per-channel variants caused the consistency problem the whole session was about.
-- **Don't add clever/meta codas after the closing question.** Two prior attempts ("wishful Slack message", "I want to collect these") had to be fixed because they were too clever for the reader. Plain question close, full stop.
-- **Don't suggest building product features speculatively.** Build bets in `market_signals.md` are *candidates* — build only after Week-7+ signals justify. "Don't build on spec."
-- **Don't write more posts on spec before the Week-4 verdict.** If the format doesn't travel, posts 7+ are wasted on a wrong format.
-- **The file `mot_reaction_series.md` is misnamed** (no MoT anymore). Rename to `linkedin_posts.md` is a pending cleanup; cross-refs in `gtm_plan.md` and `linkedin_series.md` will need updating in the same pass.
-
-## How to handle common requests
-
-- **"Give me the next post" / "what should I post":** check the Progress Log in `gtm_plan.md` to see which posts are scheduled vs sent. Posts live in `mot_reaction_series.md`. Format LinkedIn-ready: strip the internal `## N. Title` label; strip markdown asterisks (LinkedIn shows them literally); append the canonical ending; append the tag line; provide the first-comment text separately. Image: real cropped screenshot if a genuine source exists, otherwise text-only.
-- **"Reply to this comment":** stay in voice; *extend* the discussion, never thank generically; no Norn pitch in the reply (the bio carries it); reply **fast** — early engagement is the single biggest reach lever, far above any other tactic.
-- **"How's the post doing?" / metrics:** calibrate via ratios more than raw numbers. Comment-to-reaction ratio above ~8% = high engagement. A **Send** (LinkedIn DM forward) is the highest-value action — it's the peer-to-peer endorsement the plan was built for. Saves > likes in intent. n=1 is not a trend.
-- **"Week-N review":** open the kill-criteria table in `gtm_plan.md` (dates anchored to 2026-05-21 launch). Evaluate signals honestly against the rule. **The pre-committed exit only works if the review actually happens** — sunk cost will narrate; resist it.
-- **New community pain signal (Reddit/Lobsters/HN):** append verbatim quote + URL + date to `Docs/market_signals.md`, triage into LinkedIn angle + build-bet columns. Don't let mining displace posting.
-
-## Working style with Peter
-
-- Convert relative dates to absolute when logging (UK timezone).
-- Peter is a non-writer; he trusts drafts. When asked for content, give **clean, copy-pasteable** text. No padding, no "here you go" framing.
-- Peter values **brevity, decisiveness, and honest pushback** over compliance. If something he's about to do is wrong, say so directly with reasoning. Don't be a yes-man — he's caught me on it before.
-- **Consistency is his #1 value.** Keep the Docs as the single source of truth. Any time copy gets revised, sync everywhere it appears.
-- When in doubt about state, **read the bottom of `gtm_plan.md`'s Progress Log** — that's where the truth lives.
-
----
-
-This skill is the index. The `Docs/` files are the canon. When in doubt, read them.

package/out/apiResponseIntellisenseCache.js

@@ -1,394 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseApiResponseRequestLine = parseApiResponseRequestLine;
-exports.parseApiResponseRequestText = parseApiResponseRequestText;
-exports.saveApiResponseShapeForRequest = saveApiResponseShapeForRequest;
-exports.getCachedApiResponseShapeForRequest = getCachedApiResponseShapeForRequest;
-exports.getApiResponseShapeNodeAtPath = getApiResponseShapeNodeAtPath;
-exports.getApiResponseShapeProperties = getApiResponseShapeProperties;
-exports.getApiResponseShapeTypeSummary = getApiResponseShapeTypeSummary;
-exports.parseApiResponseBodyPathForCompletion = parseApiResponseBodyPathForCompletion;
-const crypto = __importStar(require("crypto"));
-const path = __importStar(require("path"));
-const cacheDir_1 = require("./cacheDir");
-const stringUtils_1 = require("./stringUtils");
-const CACHE_VERSION = 1;
-const CACHE_FILE = 'api-response-intellisense.json';
-const MAX_DEPTH = 6;
-const MAX_OBJECT_PROPERTIES = 100;
-const MAX_ARRAY_ITEMS = 20;
-function removeRetryOptions(value) {
-    return value
-        .replace(/\bretry\s+\d+\b/ig, '')
-        .replace(/\bbackoff\s+\d+(?:\.\d+)?\s*(?:s|ms|seconds?|milliseconds?)?\b/ig, '')
-        .trim();
-}
-function normalizeQuotedTarget(target) {
-    const trimmed = target.trim();
-    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
-        (trimmed.startsWith('\'') && trimmed.endsWith('\''))) {
-        return trimmed.slice(1, -1).trim();
-    }
-    return trimmed;
-}
-function normalizeTargetForIdentity(target) {
-    return normalizeQuotedTarget(removeRetryOptions(target)).replace(/\s+/g, ' ').trim();
-}
-function hashTarget(target) {
-    return crypto.createHash('sha256').update(target).digest('hex').slice(0, 16);
-}
-function redactSensitiveTargetParts(target) {
-    let redacted = target.replace(/(https?:\/\/)([^/\s:@]+):([^/\s@]+)@/ig, '$1***@');
-    redacted = redacted.replace(/([?&][^=&\s]*(?:token|secret|password|passwd|pwd|key|auth|signature|sig)[^=&\s]*=)[^&\s]+/ig, '$1***');
-    redacted = redacted.replace(/\b(?:bearer|basic)\s+[a-z0-9._~+/=-]+/ig, match => `${match.split(/\s+/)[0]} ***`);
-    return redacted;
-}
-function normalizeEnvironment(environment) {
-    const trimmed = environment?.trim();
-    return trimmed ? trimmed : undefined;
-}
-function normalizeIdentity(identity) {
-    const rootPath = (0, cacheDir_1.findProjectRoot)(identity.sourceFile);
-    const absoluteSourceFile = path.resolve(identity.sourceFile);
-    const relativeSourceFile = path.relative(rootPath, absoluteSourceFile).replace(/\\/g, '/');
-    const target = normalizeTargetForIdentity(identity.target);
-    return {
-        rootPath,
-        sourceFile: relativeSourceFile || path.basename(absoluteSourceFile),
-        sourceLine: identity.sourceLine,
-        method: identity.method.toUpperCase(),
-        target,
-        targetHash: hashTarget(target),
-        environment: normalizeEnvironment(identity.environment)
-    };
-}
-function buildCacheKey(identity) {
-    return [
-        identity.sourceFile,
-        identity.sourceLine === undefined ? '' : String(identity.sourceLine),
-        identity.method,
-        identity.targetHash,
-        identity.environment ?? ''
-    ].map(encodeURIComponent).join('|');
-}
-function getCachePath(rootPath) {
-    return (0, cacheDir_1.getNornCacheFilePath)(rootPath, CACHE_FILE);
-}
-function loadCache(rootPath) {
-    return (0, cacheDir_1.loadVersionedJsonCache)({
-        cachePath: getCachePath(rootPath),
-        version: CACHE_VERSION,
-        createDefault: () => ({ version: CACHE_VERSION, entries: {} }),
-        isValid: cache => typeof cache.entries === 'object' && cache.entries !== null
-    });
-}
-function saveCache(rootPath, cache) {
-    return (0, cacheDir_1.saveVersionedJsonCache)(getCachePath(rootPath), cache, () => !!(0, cacheDir_1.ensureNornCacheDir)(rootPath));
-}
-function parseApiResponseRequestLine(line) {
-    const trimmed = (0, stringUtils_1.stripInlineComment)(line).trim();
-    const varMatch = trimmed.match(/^var\s+([a-zA-Z_][a-zA-Z0-9_]*)\s*=\s*(GET|POST|PUT|DELETE|PATCH|HEAD|OPTIONS)\s+(.+)$/i);
-    if (varMatch) {
-        return {
-            variableName: varMatch[1],
-            method: varMatch[2].toUpperCase(),
-            target: normalizeTargetForIdentity(varMatch[3])
-        };
-    }
-    const requestMatch = trimmed.match(/^(GET|POST|PUT|DELETE|PATCH|HEAD|OPTIONS)\s+(.+)$/i);
-    if (!requestMatch) {
-        return undefined;
-    }
-    return {
-        method: requestMatch[1].toUpperCase(),
-        target: normalizeTargetForIdentity(requestMatch[2])
-    };
-}
-function parseApiResponseRequestText(requestText) {
-    const lines = requestText.split('\n');
-    for (let lineOffset = 0; lineOffset < lines.length; lineOffset++) {
-        const request = parseApiResponseRequestLine(lines[lineOffset]);
-        if (request) {
-            return { lineOffset, request };
-        }
-    }
-    return undefined;
-}
-function getCacheableJsonRoot(responseBody) {
-    let candidate = responseBody;
-    if (typeof candidate === 'string') {
-        try {
-            candidate = JSON.parse(candidate);
-        }
-        catch {
-            return undefined;
-        }
-    }
-    if (candidate !== null && typeof candidate === 'object') {
-        return candidate;
-    }
-    return undefined;
-}
-function getPrimitiveShape(value) {
-    if (value === null) {
-        return { type: 'null' };
-    }
-    switch (typeof value) {
-        case 'string':
-            return { type: 'string' };
-        case 'number':
-            return { type: 'number' };
-        case 'boolean':
-            return { type: 'boolean' };
-        default:
-            return { type: 'unknown' };
-    }
-}
-function buildShape(value, depth = 0) {
-    if (depth >= MAX_DEPTH) {
-        if (Array.isArray(value)) {
-            return { type: 'array', items: { type: 'unknown' } };
-        }
-        if (value !== null && typeof value === 'object') {
-            return { type: 'object', properties: {} };
-        }
-        return getPrimitiveShape(value);
-    }
-    if (Array.isArray(value)) {
-        const itemShapes = value
-            .slice(0, MAX_ARRAY_ITEMS)
-            .map(item => buildShape(item, depth + 1));
-        return {
-            type: 'array',
-            items: mergeShapes(itemShapes)
-        };
-    }
-    if (value !== null && typeof value === 'object') {
-        const properties = {};
-        const entries = Object.entries(value).slice(0, MAX_OBJECT_PROPERTIES);
-        for (const [name, propertyValue] of entries) {
-            properties[name] = buildShape(propertyValue, depth + 1);
-        }
-        return { type: 'object', properties };
-    }
-    return getPrimitiveShape(value);
-}
-function mergeObjectShapes(nodes) {
-    const propertyNames = new Set();
-    for (const node of nodes) {
-        for (const name of Object.keys(node.properties ?? {})) {
-            propertyNames.add(name);
-        }
-    }
-    const properties = {};
-    for (const name of [...propertyNames].slice(0, MAX_OBJECT_PROPERTIES)) {
-        const propertyShapes = nodes
-            .map(node => node.properties?.[name])
-            .filter((node) => Boolean(node));
-        properties[name] = mergeShapes(propertyShapes);
-    }
-    return { type: 'object', properties };
-}
-function mergeArrayShapes(nodes) {
-    return {
-        type: 'array',
-        items: mergeShapes(nodes
-            .map(node => node.items)
-            .filter((node) => Boolean(node)))
-    };
-}
-function mergeShapes(nodes) {
-    if (nodes.length === 0) {
-        return { type: 'unknown' };
-    }
-    const hasNull = nodes.some(node => node.type === 'null');
-    const nonNullNodes = nodes.filter(node => node.type !== 'null');
-    const effectiveNodes = nonNullNodes.length > 0 ? nonNullNodes : nodes;
-    const firstType = effectiveNodes[0].type;
-    const sameType = effectiveNodes.every(node => node.type === firstType);
-    if (!sameType) {
-        return { type: 'unknown', nullable: hasNull || undefined };
-    }
-    let merged;
-    if (firstType === 'object') {
-        merged = mergeObjectShapes(effectiveNodes);
-    }
-    else if (firstType === 'array') {
-        merged = mergeArrayShapes(effectiveNodes);
-    }
-    else {
-        merged = { type: firstType };
-    }
-    if (hasNull && merged.type !== 'null') {
-        merged.nullable = true;
-    }
-    return merged;
-}
-function saveApiResponseShapeForRequest(identity, responseBody) {
-    const root = getCacheableJsonRoot(responseBody);
-    if (root === undefined) {
-        return false;
-    }
-    const shape = buildShape(root);
-    if (shape.type !== 'object' && shape.type !== 'array') {
-        return false;
-    }
-    const normalizedIdentity = normalizeIdentity(identity);
-    const cache = loadCache(normalizedIdentity.rootPath);
-    const key = buildCacheKey(normalizedIdentity);
-    cache.entries[key] = {
-        method: normalizedIdentity.method,
-        target: redactSensitiveTargetParts(normalizedIdentity.target),
-        targetHash: normalizedIdentity.targetHash,
-        sourceFile: normalizedIdentity.sourceFile,
-        sourceLine: normalizedIdentity.sourceLine,
-        environment: normalizedIdentity.environment,
-        cachedAt: new Date().toISOString(),
-        shape
-    };
-    return saveCache(normalizedIdentity.rootPath, cache);
-}
-function findBestEntry(entries, identity) {
-    const exactLineEntries = entries.filter(entry => entry.sourceLine === identity.sourceLine);
-    const linePreferredEntries = exactLineEntries.length > 0 ? exactLineEntries : entries;
-    const exactEnvironment = identity.environment
-        ? linePreferredEntries.find(entry => entry.environment === identity.environment)
-        : undefined;
-    if (exactEnvironment) {
-        return exactEnvironment;
-    }
-    const noEnvironment = linePreferredEntries.find(entry => !entry.environment);
-    if (noEnvironment) {
-        return noEnvironment;
-    }
-    return linePreferredEntries
-        .slice()
-        .sort((a, b) => b.cachedAt.localeCompare(a.cachedAt))[0];
-}
-function getCachedApiResponseShapeForRequest(identity) {
-    const normalizedIdentity = normalizeIdentity(identity);
-    const cache = loadCache(normalizedIdentity.rootPath);
-    const exactKey = buildCacheKey(normalizedIdentity);
-    const exactEntry = cache.entries[exactKey];
-    if (exactEntry) {
-        return exactEntry;
-    }
-    const candidates = Object.values(cache.entries).filter(entry => entry.sourceFile === normalizedIdentity.sourceFile &&
-        entry.method === normalizedIdentity.method &&
-        entry.targetHash === normalizedIdentity.targetHash);
-    return findBestEntry(candidates, normalizedIdentity);
-}
-function isNumericSegment(segment) {
-    return /^\d+$/.test(segment);
-}
-function getApiResponseShapeNodeAtPath(shape, pathSegments) {
-    let current = shape;
-    for (const segment of pathSegments) {
-        if (!current) {
-            return undefined;
-        }
-        if (current.type === 'array') {
-            current = current.items;
-            if (isNumericSegment(segment)) {
-                continue;
-            }
-        }
-        if (current?.type !== 'object') {
-            return undefined;
-        }
-        current = current.properties?.[segment];
-    }
-    return current;
-}
-function isPathSafePropertyName(name) {
-    return /^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(name);
-}
-function getApiResponseShapeProperties(node) {
-    if (!node) {
-        return [];
-    }
-    if (node.type === 'array') {
-        const itemProperties = getApiResponseShapeProperties(node.items);
-        return [
-            { name: 'count', shape: { type: 'number' } },
-            ...itemProperties
-        ];
-    }
-    if (node.type !== 'object' || !node.properties) {
-        return [];
-    }
-    return Object.entries(node.properties)
-        .filter(([name]) => isPathSafePropertyName(name))
-        .map(([name, shape]) => ({ name, shape }))
-        .sort((a, b) => a.name.localeCompare(b.name));
-}
-function getApiResponseShapeTypeSummary(node) {
-    let summary;
-    if (node.type === 'array') {
-        const itemSummary = node.items ? getApiResponseShapeTypeSummary(node.items) : 'unknown';
-        summary = `array<${itemSummary}>`;
-    }
-    else {
-        summary = node.type;
-    }
-    return node.nullable ? `${summary} | null` : summary;
-}
-function parseApiResponseBodyPathForCompletion(suffix) {
-    const pathSuffix = suffix.startsWith('[') ? `.${suffix}` : suffix;
-    if (!pathSuffix.startsWith('.')) {
-        return undefined;
-    }
-    const normalized = pathSuffix.replace(/\[(\d+)\]/g, '.$1');
-    if (!normalized.startsWith('.')) {
-        return undefined;
-    }
-    const withoutLeadingDot = normalized.slice(1);
-    const endsAtSeparator = normalized.endsWith('.');
-    const rawParts = withoutLeadingDot.split('.');
-    const nonEmptyParts = rawParts.filter(part => part !== '');
-    if (endsAtSeparator) {
-        return {
-            pathSegments: nonEmptyParts,
-            partial: ''
-        };
-    }
-    const partial = nonEmptyParts.at(-1) ?? '';
-    return {
-        pathSegments: nonEmptyParts.slice(0, -1),
-        partial
-    };
-}
-//# sourceMappingURL=apiResponseIntellisenseCache.js.map