@portel/photon 1.16.0 → 1.17.0

package/dist/photons/builder-compass.photon.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Builder Compass
+ * @description Discover your strongest AI-native builder profile, research how people like you make money, and get an evidence-backed next-step roadmap.
+ * @icon 🧭
+ * @stateful
+ * @ui app ./ui/builder-compass.html
+ */
+type ArchetypeTag = 'ai-augmented-solo-builder' | 'agent-workflow-architect' | 'developer-tools-builder' | 'high-agency-integrator' | 'implementation-consultant' | 'product-technical-translator' | 'prototype-driven-founder' | 'systems-minded-operator';
+type StrengthTag = 'ambiguity-tolerance' | 'architecture' | 'communication' | 'curiosity' | 'design-taste' | 'distribution' | 'execution' | 'integration' | 'judgment' | 'product-intuition' | 'rapid-prototyping' | 'research' | 'systems-thinking' | 'workflow-design';
+type WorkFitTag = 'ai-application-engineering' | 'consulting' | 'developer-tools' | 'founder-path' | 'hybrid-product-technical' | 'implementation-work' | 'indie-hacking' | 'prototype-work' | 'technical-education' | 'workflow-automation';
+type RiskTag = 'ai-overreliance' | 'identity-diffusion' | 'novelty-chasing' | 'overextension' | 'prestige-chasing' | 'weak-finish-loops';
+type MoneyModeTag = 'audience-plus-product' | 'consulting-sprints' | 'education-products' | 'retainer-implementation' | 'sell-tools' | 'startup-wedge' | 'template-productization';
+interface LinkEvidence {
+    label: string;
+    url: string;
+    reason: string;
+}
+interface ProfileInput {
+    name: string;
+    headline: string;
+    goalNow: string;
+    recentWork: string;
+    energizingWork: string;
+    constraints: string;
+    links: string[];
+}
+interface BuilderProfile extends ProfileInput {
+    updatedAt: string;
+}
+interface StrengthMatrixRow {
+    category: string;
+    score: number;
+    confidence: number;
+    energyFit: number;
+    strategicRelevance: number;
+    riskLoad: number;
+    rationale: string;
+    basis: 'natural aptitude' | 'learned competence' | 'aspirational identity';
+}
+interface IdentityAnalysis {
+    status: 'idle' | 'heuristic' | 'tinyfish';
+    title: string;
+    archetypeStatement: string;
+    identitySummary: string;
+    archetypeTags: ArchetypeTag[];
+    strengthTags: StrengthTag[];
+    workFitTags: WorkFitTag[];
+    riskTags: RiskTag[];
+    moneyModeTags: MoneyModeTag[];
+    strengthMatrix: StrengthMatrixRow[];
+    evidence: LinkEvidence[];
+    confidence: number;
+    lastUpdatedAt: string;
+}
+interface MoneyPath {
+    title: string;
+    category: 'fastest-path' | 'compounding-path' | 'hybrid-path' | 'safe-path';
+    fitScore: number;
+    speedToMoney: number;
+    marketDemand: number;
+    sustainability: number;
+    executionDifficulty: number;
+    whyItFits: string;
+    examples: string[];
+    channels: string[];
+    firstSteps: string[];
+    risks: string[];
+}
+interface MarketResearch {
+    status: 'idle' | 'heuristic' | 'tinyfish';
+    researchSummary: string;
+    topPaths: MoneyPath[];
+    avoidPaths: string[];
+    nextMoves: string[];
+    evidence: LinkEvidence[];
+    lastUpdatedAt: string;
+}
+interface CompassSnapshot {
+    productName: string;
+    profile: BuilderProfile;
+    identity: IdentityAnalysis;
+    market: MarketResearch;
+    apiKeyConfigured: boolean;
+    readyState: {
+        hasProfile: boolean;
+        hasIdentity: boolean;
+        hasMarket: boolean;
+    };
+}
+export default class BuilderCompass {
+    tinyfishApiKey: string;
+    profile: BuilderProfile;
+    identity: IdentityAnalysis;
+    market: MarketResearch;
+    constructor();
+    /**
+     * Open the Builder Compass dashboard
+     * @ui app
+     */
+    main(): Promise<CompassSnapshot>;
+    /**
+     * Save the builder profile and optional TinyFish API key
+     */
+    saveProfile(params: ProfileInput & {
+        tinyfishApiKey?: string;
+    }): Promise<CompassSnapshot>;
+    /**
+     * Analyze the builder's identity, strengths, work fit, and risks
+     */
+    analyzeIdentity(): Promise<IdentityAnalysis>;
+    /**
+     * Research how people with this profile are making money right now
+     */
+    researchMarket(): Promise<MarketResearch>;
+    /**
+     * Run the full builder compass flow end to end
+     */
+    runCompass(): Promise<CompassSnapshot>;
+    /**
+     * Structured strengths matrix for agents and dashboards
+     * @format table
+     */
+    strengthMatrix(): Promise<Array<Record<string, string | number>>>;
+    /**
+     * Ranked money paths for this builder profile
+     * @format table
+     */
+    moneyPaths(): Promise<Array<Record<string, string | number>>>;
+    /**
+     * Quick visual fit panel for the dashboard
+     * @format panels
+     */
+    fitOverview(): Promise<Array<{
+        label: string;
+        value: number;
+        note: string;
+    }>>;
+    /**
+     * Full narrative guide for the user
+     * @format markdown
+     */
+    report(): Promise<string>;
+    private _snapshot;
+    private _blankIdentity;
+    private _blankMarket;
+    private _ensureProfile;
+    private _canUseTinyFish;
+    private _heuristicIdentity;
+    private _heuristicMarket;
+    private _tinyfishIdentity;
+    private _tinyfishMarket;
+    private _runTinyFishSearch;
+    private _pollTinyFishRun;
+    private _extractJson;
+    private _buildStrengthMatrix;
+    private _row;
+    private _normalizeEvidence;
+    private _filterAllowed;
+    private _stringArray;
+    private _toUnit;
+    private _allowedPathCategory;
+    private _labelize;
+    private _dedupe;
+    private _allTags;
+}
+export {};
+//# sourceMappingURL=builder-compass.photon.d.ts.map

package/dist/photons/builder-compass.photon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-compass.photon.d.ts","sourceRoot":"","sources":["../../src/photons/builder-compass.photon.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,YAAY,GACb,2BAA2B,GAC3B,0BAA0B,GAC1B,yBAAyB,GACzB,wBAAwB,GACxB,2BAA2B,GAC3B,8BAA8B,GAC9B,0BAA0B,GAC1B,yBAAyB,CAAC;AAE9B,KAAK,WAAW,GACZ,qBAAqB,GACrB,cAAc,GACd,eAAe,GACf,WAAW,GACX,cAAc,GACd,cAAc,GACd,WAAW,GACX,aAAa,GACb,UAAU,GACV,mBAAmB,GACnB,mBAAmB,GACnB,UAAU,GACV,kBAAkB,GAClB,iBAAiB,CAAC;AAEtB,KAAK,UAAU,GACX,4BAA4B,GAC5B,YAAY,GACZ,iBAAiB,GACjB,cAAc,GACd,0BAA0B,GAC1B,qBAAqB,GACrB,eAAe,GACf,gBAAgB,GAChB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,KAAK,OAAO,GACR,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,eAAe,GACf,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,KAAK,YAAY,GACb,uBAAuB,GACvB,oBAAoB,GACpB,oBAAoB,GACpB,yBAAyB,GACzB,YAAY,GACZ,eAAe,GACf,yBAAyB,CAAC;AAE9B,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,cAAe,SAAQ,YAAY;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;CAC5E;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,GAAG,kBAAkB,GAAG,aAAa,GAAG,WAAW,CAAC;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE;QACV,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAOD,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;;IAmBvB;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAItC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAyD/F;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAalD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC;IAgB/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAM5C;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAiBvE;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAiBnE;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA0CnF;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAmC/B,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,kBAAkB;IAgH1B,OAAO,CAAC,gBAAgB;YAyGV,iBAAiB;YA8KjB,eAAe;YA8Cf,kBAAkB;YA+BlB,gBAAgB;IAyB9B,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,oBAAoB;IA2E5B,OAAO,CAAC,IAAI;IAsBZ,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,QAAQ;CAGjB"}