@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.100

package/dist/formatters/handshake.js

@@ -0,0 +1,163 @@
+/**
+ * Handshake formatter — console report after file generation.
+ */
+export function formatHandshakeReport(report) {
+    const lines = [];
+    const name = report.repo.name ?? 'unknown';
+    const slug = report.repo.repoSlug ? ` (${report.repo.repoSlug})` : '';
+    if (report.preview && report.previewPlan) {
+        // Preview mode output
+        lines.push('pb handshake — preview (run with --apply to write)');
+        lines.push('');
+        lines.push(`Repo: ${name}${slug}`);
+        if (report.repo.detectedStack.length > 0) {
+            lines.push(`Stack: ${report.repo.detectedStack.join(', ')}`);
+        }
+        lines.push('');
+        lines.push('Plan:');
+        const statusSymbol = {
+            'would-write': '+',
+            'would-update': '↑',
+            'unchanged': '✓',
+            'forked': '⚠',
+            'filtered': '·',
+        };
+        const statusLabel = {
+            'would-write': 'would write',
+            'would-update': 'would update',
+            'unchanged': 'unchanged',
+            'forked': 'forked — has no auto-generated marker, use --force to overwrite',
+            'filtered': 'filtered by surface',
+        };
+        for (const item of report.previewPlan) {
+            lines.push(`  ${statusSymbol[item.status]} ${item.path}  (${statusLabel[item.status]})`);
+        }
+        const wouldWrite = report.previewPlan.filter((i) => i.status === 'would-write' || i.status === 'would-update').length;
+        const unchanged = report.previewPlan.filter((i) => i.status === 'unchanged').length;
+        const forked = report.previewPlan.filter((i) => i.status === 'forked').length;
+        const filtered = report.previewPlan.filter((i) => i.status === 'filtered').length;
+        const summary = [];
+        if (wouldWrite > 0)
+            summary.push(`${wouldWrite} would write`);
+        if (unchanged > 0)
+            summary.push(`${unchanged} unchanged`);
+        if (forked > 0)
+            summary.push(`${forked} forked`);
+        if (filtered > 0)
+            summary.push(`${filtered} filtered`);
+        lines.push('');
+        lines.push(`  ${summary.join(', ')}`);
+        lines.push('');
+        lines.push('Run `pb handshake --apply` to write these files.');
+        return lines.join('\n');
+    }
+    // Apply / dry-run mode output (existing format)
+    lines.push('pb handshake — context files generated');
+    lines.push('');
+    // Repo info
+    lines.push(`Repo: ${name}${slug}`);
+    if (report.repo.detectedStack.length > 0) {
+        lines.push(`Stack: ${report.repo.detectedStack.join(', ')}`);
+    }
+    lines.push('');
+    // Written files
+    if (report.filesWritten.length > 0) {
+        lines.push('Written:');
+        for (const f of report.filesWritten) {
+            lines.push(`  ${f}`);
+        }
+        lines.push('');
+    }
+    // Skipped files
+    if (report.filesSkipped.length > 0) {
+        lines.push('Skipped:');
+        for (const f of report.filesSkipped) {
+            lines.push(`  ${f.path} — ${f.reason}`);
+        }
+        lines.push('');
+    }
+    // Matched entries
+    if (report.matchedEntries.length > 0) {
+        lines.push(`Matched ${report.matchedEntries.length} Chain entries:`);
+        for (const e of report.matchedEntries.slice(0, 20)) {
+            const id = e.entryId ?? e.name;
+            const coll = e.collectionSlug ?? '—';
+            lines.push(`  ${id}  [${coll}]  ${e.name}`);
+        }
+        if (report.matchedEntries.length > 20) {
+            lines.push(`  ... and ${report.matchedEntries.length - 20} more`);
+        }
+        lines.push('');
+    }
+    // Chain-derived rules stats (--generate)
+    if (report.chainRulesStats) {
+        const { generatedRules, suppressedByManual, suppressedByZeroEntries, totalEntries } = report.chainRulesStats;
+        lines.push(`Chain-derived rules: ${generatedRules} generated, ${suppressedByManual} suppressed by manual, ${suppressedByZeroEntries} gaps (from ${totalEntries} governance entries)`);
+        if (report.chainGaps && report.chainGaps.length > 0) {
+            lines.push(`Gaps (no matching governance entries): ${report.chainGaps.join(', ')}`);
+        }
+        lines.push('');
+    }
+    // Codex dead-reference warnings
+    if (report.codexWarnings && report.codexWarnings.length > 0) {
+        lines.push(`Codex warnings (${report.codexWarnings.length} dead reference(s) in projected skills):`);
+        for (const w of report.codexWarnings) {
+            lines.push(`  ${w.skillName}: ${w.pattern} — "${w.line}"`);
+        }
+        lines.push('  (These references may not work in Codex. Consider transport sections or targets.)');
+        lines.push('');
+    }
+    // Manifest adoption counts
+    if (report.adoptedCount !== undefined || report.rejectedCount !== undefined) {
+        const parts = [];
+        if (report.adoptedCount !== undefined)
+            parts.push(`${report.adoptedCount} adopted`);
+        if (report.rejectedCount !== undefined)
+            parts.push(`${report.rejectedCount} rejected`);
+        if (parts.length > 0) {
+            lines.push(`Manifest filter: ${parts.join(', ')}`);
+            lines.push('');
+        }
+    }
+    // Personal layer
+    const personalItems = [];
+    if (report.personalRuleCount !== undefined && report.personalRuleCount > 0) {
+        personalItems.push(`${report.personalRuleCount} rule(s)`);
+    }
+    if (report.personalSkillCount !== undefined && report.personalSkillCount > 0) {
+        personalItems.push(`${report.personalSkillCount} skill(s)`);
+    }
+    if (personalItems.length > 0) {
+        lines.push(`Personal layer (local only): ${personalItems.join(', ')}`);
+        lines.push('');
+    }
+    // Method registry
+    if (report.registrySource !== undefined) {
+        if (report.registrySource === 'chain') {
+            lines.push('✓ Method registry: live from Chain');
+        }
+        else if (report.registryStale) {
+            lines.push('⚠ Method registry: bundled (>7 days old — run pb handshake to refresh)');
+        }
+        else {
+            lines.push('✓ Method registry: bundled');
+        }
+        lines.push('');
+    }
+    // Drift conflicts (forked adapters encountered during apply)
+    if (report.driftConflicts && report.driftConflicts.length > 0) {
+        const n = report.driftConflicts.length;
+        lines.push(`⚠ ${n} forked adapter(s) blocked sync — logged as draft TEN(s) on the Chain:`);
+        for (const p of report.driftConflicts) {
+            lines.push(`  ${p}`);
+        }
+        lines.push('  Use --force to overwrite, or resolve drift manually.');
+        lines.push('');
+    }
+    lines.push('Tip: Add .productbrain/ to .gitignore (contains workspace-specific context).');
+    lines.push('     Adapter files (AGENTS.md, .codex/skills/, CLAUDE.md, .cursor/rules/, .claude/rules/, .github/) are safe to commit.');
+    lines.push('');
+    lines.push('Run `pb handshake` again to refresh.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=handshake.js.map

package/dist/formatters/handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../../src/formatters/handshake.ts"],"names":[],"mappings":"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"}

package/dist/formatters/orient.d.ts

@@ -19,6 +19,7 @@ export interface OrientView {
         collectionSlug: string | null;
         status: string;
         preview?: string;
+        origin?: 'human' | 'agent' | 'external';
         linkedTensions?: Array<{
             entryId: string | null;
             name: string;
@@ -28,17 +29,29 @@ export interface OrientView {
         principles: Array<{
             entryId: string | null;
             name: string;
+            collectionSlug: string | null;
+            status: string;
             preview?: string;
+            scoreFlags?: string[];
+            origin?: 'human' | 'agent' | 'external';
         }>;
         standards: Array<{
             entryId: string | null;
             name: string;
+            collectionSlug: string | null;
+            status: string;
             preview?: string;
+            scoreFlags?: string[];
+            origin?: 'human' | 'agent' | 'external';
         }>;
         businessRules: Array<{
             entryId: string | null;
             name: string;
+            collectionSlug: string | null;
+            status: string;
             preview?: string;
+            scoreFlags?: string[];
+            origin?: 'human' | 'agent' | 'external';
         }>;
     };
     tensions: Array<{
@@ -61,6 +74,101 @@ export interface OrientView {
         message: string;
         suggestion?: string;
     }>;
+    startup?: {
+        groundingStatus: 'grounded' | 'partial' | 'missing';
+        confidence: string;
+        totalFound: number;
+        seeds: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+        }>;
+        bindingGovernance: {
+            principles: Array<{
+                entryId: string | null;
+                name: string;
+                collectionSlug: string | null;
+                preview?: string;
+            }>;
+            standards: Array<{
+                entryId: string | null;
+                name: string;
+                collectionSlug: string | null;
+                preview?: string;
+            }>;
+            businessRules: Array<{
+                entryId: string | null;
+                name: string;
+                collectionSlug: string | null;
+                preview?: string;
+            }>;
+        };
+        domainRetrieval?: {
+            state: string;
+            resolvedDomainSlug?: string;
+            fallbackReason?: string;
+            fallbackAction?: string;
+            evidenceGap?: string;
+            directRatifiedCount?: number;
+            inheritedRatifiedCount?: number;
+            orgFallbackCount?: number;
+            activeSource?: string;
+            legacyUnauditedCount?: number;
+            invalidRelationCount?: number;
+            nonOverlapMetric?: {
+                status: string;
+                value?: number;
+                reason?: string;
+                action?: string;
+            };
+            primerByteDelta?: {
+                status: string;
+                value?: number;
+                reason?: string;
+                action?: string;
+            };
+        };
+        steeringContext: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+            score: number;
+            hop: number;
+            preview?: string;
+            origin?: 'human' | 'agent' | 'external';
+        }>;
+        supportingContext: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+            score: number;
+            hop: number;
+            preview?: string;
+            origin?: 'human' | 'agent' | 'external';
+        }>;
+        taskProfile: {
+            workType: string;
+            domain: string;
+            keywords: string[];
+        };
+    };
+    taskContext?: {
+        seeds: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+        }>;
+        context: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+            score: number;
+            hop: number;
+            origin?: 'human' | 'agent' | 'external';
+        }>;
+        totalFound: number;
+        confidence: string;
+    };
     plannedWork: {
         uncommittedDrafts: Array<{
             name: string;
@@ -80,20 +188,40 @@ export interface OrientView {
         sessionId: string;
         status: string;
         startedAt: number;
+        closedAt?: number;
         entriesCreated: string[];
         entriesModified: string[];
+        relationsCreated: number;
     }>;
     recoveryBlock: {
         sessionId: string;
-        status: string;
+        status: 'timed_out' | 'completed';
         date: string;
         duration: string;
+        created: Array<{
+            entryId: string;
+            collection: string;
+            name: string;
+        }>;
+        modified: Array<{
+            entryId: string;
+            collection: string;
+            name: string;
+        }>;
         draftsNeedingAttention: Array<{
             entryId: string;
             collection: string;
             name: string;
         }>;
+        relationsCreated: number;
+        createdOverflow?: number;
+        modifiedOverflow?: number;
+        draftsOverflow?: number;
     } | null;
+    writeBackHints?: Array<{
+        collectionSlug: string;
+        hint: string;
+    }>;
 }
 /** Full orient output — all sections per ARCH-25. */
 export declare function formatOrient(view: OrientView): string;

package/dist/formatters/orient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orient.d.ts","sourceRoot":"","sources":["../../src/formatters/orient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orient.d.ts","sourceRoot":"","sources":["../../src/formatters/orient.ts"],"names":[],"mappings":"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"}

package/dist/formatters/orient.js

@@ -2,18 +2,41 @@
  * Orient formatter — full ARCH-25 sections for CLI display.
  * Chain: DEC-186 (CLI uses Convex view model with CLI-native formatting).
  */
-function section(title, items, indent = 2) {
-    if (items.length === 0)
-        return [];
-    const pad = ' '.repeat(indent);
-    return [title, '', ...items.map((i) => `${pad}• ${i}`), ''];
-}
 function formatEntryList(items, max = 5) {
     return items.slice(0, max).map((e) => {
         const id = e.entryId ?? e.name;
         return e.preview ? `${id} — ${e.preview.slice(0, 80)}${e.preview.length > 80 ? '…' : ''}` : id;
     });
 }
+function buildTaskGroundingWarningLines(startup) {
+    if (!startup) {
+        return [
+            '## Task grounding required',
+            '',
+            '  Workspace orientation is not sufficient for substantive implementation, review, diagnosis, auth, security, or governance work.',
+            '  Run `pb orient --task "<your task>"` to load binding governance and supporting context before you proceed.',
+            '',
+        ];
+    }
+    if (startup.groundingStatus === 'grounded')
+        return [];
+    if (startup.groundingStatus === 'partial') {
+        return [
+            '## Task grounding partial',
+            '',
+            '  The task matched some relevant context, but startup is still missing either binding governance or enough non-binding steering/supporting context.',
+            '  Proceed carefully and open the matched entries before substantive work.',
+            '',
+        ];
+    }
+    return [
+        '## Task grounding required',
+        '',
+        '  Workspace orientation is not sufficient for substantive implementation, review, diagnosis, auth, security, or governance work.',
+        '  Run `pb orient --task "<your task>"` to load binding governance and supporting context before you proceed.',
+        '',
+    ];
+}
 /** Full orient output — all sections per ARCH-25. */
 export function formatOrient(view) {
     const lines = [];
@@ -38,13 +61,15 @@ export function formatOrient(view) {
         lines.push(`Product areas: ${strategicContext.productAreas.join(', ')}`);
     }
     lines.push('');
+    lines.push(...buildTaskGroundingWarningLines(view.startup));
     // 2. Active bets
     if (activeBets.length > 0) {
         lines.push('## Active bets');
         lines.push('');
         for (const bet of activeBets.slice(0, 10)) {
-            const id = bet.entryId ?? bet.name;
-            lines.push(`  • ${id} — ${bet.name}`);
+            const originTag = bet.origin ? ` [${bet.origin}]` : '';
+            const betLine = bet.entryId ? `${bet.entryId} — ${bet.name}` : bet.name;
+            lines.push(`  • ${betLine}${originTag}`);
             if (bet.linkedTensions && bet.linkedTensions.length > 0) {
                 for (const t of bet.linkedTensions.slice(0, 3)) {
                     lines.push(`  ↳ ${t.name}`);
@@ -53,7 +78,84 @@ export function formatOrient(view) {
         }
         lines.push('');
     }
-    // 3. Governance
+    // 3. Task context
+    if (view.startup) {
+        const seeds = view.startup.seeds
+            .slice(0, 5)
+            .map((seed) => seed.entryId ?? seed.name)
+            .join(', ');
+        lines.push('## Task grounding');
+        lines.push('');
+        lines.push(`  Status: ${view.startup.groundingStatus}`);
+        lines.push(`  ${view.startup.totalFound} relevant entries (${view.startup.confidence} confidence)`);
+        lines.push(`  Profile: ${view.startup.taskProfile.workType} / ${view.startup.taskProfile.domain}`);
+        if (view.startup.domainRetrieval) {
+            const retrieval = view.startup.domainRetrieval;
+            const scopedTo = retrieval.resolvedDomainSlug ? ` (${retrieval.resolvedDomainSlug})` : '';
+            lines.push(`  Domain retrieval: ${retrieval.state}${scopedTo}`);
+            if (retrieval.activeSource)
+                lines.push(`  Active source: ${retrieval.activeSource}`);
+            if (retrieval.fallbackReason)
+                lines.push(`  Fallback: ${retrieval.fallbackReason}`);
+            if (retrieval.fallbackAction)
+                lines.push(`  Action: ${retrieval.fallbackAction}`);
+            if (retrieval.evidenceGap)
+                lines.push(`  Evidence gap: ${retrieval.evidenceGap}`);
+            if (typeof retrieval.legacyUnauditedCount === 'number' || typeof retrieval.invalidRelationCount === 'number') {
+                lines.push(`  Domain relation evidence: ${retrieval.legacyUnauditedCount ?? 0} legacy-unaudited, ${retrieval.invalidRelationCount ?? 0} invalid`);
+            }
+        }
+        if (seeds) {
+            lines.push(`  Seeds: ${seeds}`);
+        }
+        lines.push('');
+    }
+    if (view.startup) {
+        const startupGov = view.startup.bindingGovernance;
+        const hasStartupGov = startupGov.principles.length > 0 ||
+            startupGov.standards.length > 0 ||
+            startupGov.businessRules.length > 0;
+        if (hasStartupGov) {
+            lines.push('## Binding governance');
+            lines.push('');
+            if (startupGov.principles.length > 0) {
+                lines.push('  Principles:');
+                lines.push(...formatEntryList(startupGov.principles).map((i) => `    • ${i}`));
+            }
+            if (startupGov.standards.length > 0) {
+                lines.push('  Standards:');
+                lines.push(...formatEntryList(startupGov.standards).map((i) => `    • ${i}`));
+            }
+            if (startupGov.businessRules.length > 0) {
+                lines.push('  Business rules:');
+                lines.push(...formatEntryList(startupGov.businessRules).map((i) => `    • ${i}`));
+            }
+            lines.push('');
+        }
+        if (view.startup.steeringContext.length > 0) {
+            lines.push('## Steering context');
+            lines.push('');
+            lines.push(...formatEntryList(view.startup.steeringContext).map((i) => `  • ${i}`));
+            lines.push('');
+        }
+        if (view.startup.supportingContext.length > 0) {
+            lines.push('## Supporting context');
+            lines.push('');
+            lines.push(...formatEntryList(view.startup.supportingContext).map((i) => `  • ${i}`));
+            lines.push('');
+        }
+    }
+    // 3b. Write-back hints (task session)
+    if (view.writeBackHints && view.writeBackHints.length > 0) {
+        lines.push('## Write-back hints');
+        lines.push('');
+        lines.push('  _What to capture this session (derived from task context):_');
+        for (const h of view.writeBackHints) {
+            lines.push(`  - **${h.collectionSlug}**: ${h.hint}`);
+        }
+        lines.push('');
+    }
+    // 4. Governance
     const gov = view.governance;
     const hasGov = gov.principles.length > 0 || gov.standards.length > 0 || gov.businessRules.length > 0;
     if (hasGov) {
@@ -73,23 +175,24 @@ export function formatOrient(view) {
         }
         lines.push('');
     }
-    // 4. Open tensions
+    // 5. Open tensions
     if (view.tensions.length > 0) {
         lines.push('## Open tensions');
         lines.push('');
         for (const t of view.tensions.slice(0, 5)) {
-            lines.push(`  • ${t.entryId ?? t.name} — ${t.name}`);
+            const tensionLine = t.entryId ? `${t.entryId} — ${t.name}` : t.name;
+            lines.push(`  • ${tensionLine}`);
         }
         lines.push('');
     }
-    // 5. Architecture notes
+    // 6. Architecture notes
     if (view.architectureNotes.length > 0) {
         lines.push('## Architecture notes');
         lines.push('');
         lines.push(...formatEntryList(view.architectureNotes).map((i) => `  • ${i}`));
         lines.push('');
     }
-    // 6. Proposals
+    // 7. Proposals
     if (view.proposals.length > 0) {
         lines.push('## Open proposals');
         lines.push('');
@@ -98,7 +201,7 @@ export function formatOrient(view) {
         }
         lines.push('');
     }
-    // 7. Absence signals
+    // 8. Absence signals
     if (view.absenceSignals.length > 0) {
         lines.push('## Absence signals');
         lines.push('');
@@ -109,7 +212,7 @@ export function formatOrient(view) {
         }
         lines.push('');
     }
-    // 8. Planned work
+    // 9. Planned work
     const pw = view.plannedWork;
     const hasPlanned = pw.uncommittedDrafts.length > 0 ||
         pw.inProgressEntries.length > 0 ||
@@ -137,18 +240,33 @@ export function formatOrient(view) {
         }
         lines.push('');
     }
-    // 9. Prior sessions / recovery
+    // 10. Prior sessions / recovery
     if (view.recoveryBlock) {
         lines.push('## Previous session recovery');
         lines.push('');
         const rb = view.recoveryBlock;
         lines.push(`  ${rb.date} — ${rb.duration} (${rb.status})`);
+        if (rb.created.length > 0) {
+            lines.push(`  Created: ${rb.created.length} entries`);
+            for (const e of rb.created.slice(0, 5)) {
+                lines.push(`    • ${e.entryId} [${e.collection}] ${e.name}`);
+            }
+        }
+        if (rb.modified.length > 0) {
+            lines.push(`  Modified: ${rb.modified.length} entries`);
+            for (const e of rb.modified.slice(0, 5)) {
+                lines.push(`    • ${e.entryId} [${e.collection}] ${e.name}`);
+            }
+        }
         if (rb.draftsNeedingAttention.length > 0) {
             lines.push('  Drafts needing attention:');
             for (const d of rb.draftsNeedingAttention.slice(0, 5)) {
                 lines.push(`    • ${d.entryId} [${d.collection}] ${d.name}`);
             }
         }
+        if (rb.relationsCreated > 0) {
+            lines.push(`  Relations created: ${rb.relationsCreated}`);
+        }
         lines.push('');
     }
     else if (view.priorSessions.length > 0) {
@@ -171,7 +289,28 @@ export function formatOrientBrief(view) {
         lines.push('');
         lines.push('Bets:');
         for (const bet of view.activeBets.slice(0, 5)) {
-            lines.push(`  • ${bet.entryId ?? bet.name} ${bet.name}`);
+            const originTag = bet.origin ? ` [${bet.origin}]` : '';
+            const briefBetLine = bet.entryId ? `${bet.entryId} ${bet.name}` : bet.name;
+            lines.push(`  • ${briefBetLine}${originTag}`);
+        }
+    }
+    if (view.startup) {
+        lines.push('');
+        lines.push(`Task grounding: ${view.startup.groundingStatus} (${view.startup.totalFound} relevant entries, ${view.startup.confidence} confidence)`);
+    }
+    else if (view.taskContext) {
+        lines.push('');
+        lines.push(`Task context: ${view.taskContext.totalFound} relevant entries (${view.taskContext.confidence} confidence)`);
+    }
+    else {
+        lines.push('');
+        lines.push('Task grounding required: run `pb orient --task "<your task>"` before substantive work');
+    }
+    if (view.writeBackHints && view.writeBackHints.length > 0) {
+        lines.push('');
+        lines.push('Write-back hints (what to capture this session):');
+        for (const h of view.writeBackHints) {
+            lines.push(`  ${h.collectionSlug}: ${h.hint}`);
         }
     }
     if (view.tensions.length > 0) {