ineedcodes 0.1.0

package/packages/agent/dist/orchestrator.js

@@ -0,0 +1,135 @@
+import { randomUUID } from 'node:crypto';
+import * as path from 'node:path';
+/**
+ * Native multi-agent orchestrator (plan §9–11).
+ * Sub-agents are real isolated contexts, not simulated personas in one prompt.
+ * The Lead Agent remains the authoritative coordinator.
+ */
+export class Orchestrator {
+    maxParallel;
+    agents = new Map();
+    constructor(maxParallel = 4) {
+        this.maxParallel = maxParallel;
+    }
+    setMaxParallel(n) {
+        this.maxParallel = Math.max(1, n);
+    }
+    get runningCount() {
+        return [...this.agents.values()].filter((a) => a.status === 'running').length;
+    }
+    createTask(opts) {
+        const taskId = randomUUID();
+        const agentId = `agent-${taskId.slice(0, 8)}`;
+        const packet = {
+            taskId,
+            agentId,
+            parentAgentId: opts.parentAgentId,
+            objective: opts.objective,
+            context: opts.context ?? '',
+            constraints: opts.constraints ?? [
+                'Stay strictly within your task scope.',
+                'Do not commit or push.',
+                'Report evidence for every claim.'
+            ],
+            availableTools: opts.availableTools ?? ['*'],
+            workspace: opts.workspace ?? '.',
+            expectedResult: opts.expectedResult ?? 'A clear summary with evidence.'
+        };
+        this.agents.set(taskId, {
+            agentId,
+            parentAgentId: opts.parentAgentId,
+            capability: opts.capability,
+            status: 'pending',
+            task: packet
+        });
+        return packet;
+    }
+    canStartMore() {
+        return this.runningCount < this.maxParallel;
+    }
+    setStatus(taskId, status) {
+        const record = this.agents.get(taskId);
+        if (record)
+            record.status = status;
+    }
+    finish(taskId, result) {
+        const record = this.agents.get(taskId);
+        if (record) {
+            record.status = result.status === 'completed' ? 'completed' : 'failed';
+            record.result = result;
+        }
+    }
+    get(taskId) {
+        return this.agents.get(taskId);
+    }
+    list() {
+        return [...this.agents.values()];
+    }
+    /** Forget all agents (used by /clear). */
+    clear() {
+        this.agents.clear();
+    }
+    pendingTasks() {
+        return this.list().filter((a) => a.status === 'pending');
+    }
+    restore(record) {
+        this.agents.set(record.task.taskId, record);
+    }
+    /**
+     * Run a set of task packets in parallel (bounded by maxParallel).
+     * Each worker gets its own AgentRuntime instance via the factory.
+     */
+    async runParallel(packets, worker, hooks) {
+        const results = new Map();
+        const queue = [...packets];
+        const launchNext = async () => {
+            const packet = queue.shift();
+            if (!packet)
+                return;
+            this.setStatus(packet.taskId, 'running');
+            await hooks?.onStatus?.(packet.taskId, 'running');
+            let result;
+            try {
+                result = await worker(packet);
+            }
+            catch (err) {
+                result = {
+                    status: 'failed',
+                    summary: err instanceof Error ? err.message : String(err),
+                    evidence: [],
+                    filesChanged: [],
+                    commandsExecuted: [],
+                    unresolvedIssues: ['Worker crashed before returning a result.']
+                };
+            }
+            this.finish(packet.taskId, result);
+            results.set(packet.taskId, result);
+            await hooks?.onResult?.(packet.taskId, result);
+            if (queue.length > 0)
+                await launchNext();
+        };
+        const lanes = Math.min(this.maxParallel, Math.max(1, packets.length));
+        await Promise.all(Array.from({ length: lanes }, () => launchNext()));
+        return results;
+    }
+}
+/** Serialize a task result into compact text for the Lead Agent context. */
+export function summarizeTaskResults(results) {
+    const lines = [];
+    for (const [taskId, result] of results) {
+        lines.push(`Task ${taskId.slice(0, 8)} [${result.status}]: ${result.summary}`);
+        for (const ev of result.evidence.slice(0, 5))
+            lines.push(`  evidence: ${ev}`);
+        if (result.filesChanged.length)
+            lines.push(`  files: ${result.filesChanged.join(', ')}`);
+        if (result.tests)
+            lines.push(`  tests: ${result.tests}`);
+        for (const issue of result.unresolvedIssues)
+            lines.push(`  unresolved: ${issue}`);
+    }
+    return lines.join('\n');
+}
+export function worktreePathFor(projectRoot, label) {
+    return path.join(projectRoot, '.ineedcodes', label);
+}
+//# sourceMappingURL=orchestrator.js.map

package/packages/agent/dist/orchestrator.js.map

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

package/packages/agent/dist/runtime.d.ts

@@ -0,0 +1,44 @@
+import type { ChatMessage, LLMProvider, MemoryProvider, ToolContext, ToolRegistry } from '@ineedcodes/core';
+export interface RuntimeServices {
+    provider: LLMProvider;
+    registry: ToolRegistry;
+    memory: MemoryProvider;
+    toolContext: ToolContext;
+    systemPrompt: string;
+    maxTurns: number;
+    /** plan = read-only exploration; build = full tool access. */
+    mode?: 'plan' | 'build';
+    reasoningEffort?: 'low' | 'medium' | 'high';
+}
+export type StopReason = 'complete' | 'needs_approval' | 'needs_information' | 'max_turns' | 'aborted' | 'error';
+export interface RuntimeOutcome {
+    stopReason: StopReason;
+    finalMessage: string;
+    turns: number;
+    toolCalls: number;
+}
+export interface ApprovalRequest {
+    tool: string;
+    reason: string;
+}
+/**
+ * The real iterative agent loop (plan §7):
+ * reason → tool call → observe actual result → update state → repeat → verify.
+ */
+export declare class AgentRuntime {
+    private readonly services;
+    private readonly emit;
+    private readonly requestApproval?;
+    private signal?;
+    private engine;
+    constructor(services: RuntimeServices, emit: (event: import('./events.js').RuntimeEvent) => Promise<void>, requestApproval?: ((req: ApprovalRequest) => Promise<boolean>) | undefined, initialMessages?: ChatMessage[], signal?: AbortSignal | undefined);
+    get messages(): readonly ChatMessage[];
+    run(objective: string): Promise<RuntimeOutcome>;
+    /**
+     * Second-chance verification: when the model stops calling tools, require it
+     * to either present evidence of completion or state what is missing.
+     * Returns the single final answer (never duplicated to the UI).
+     */
+    private verifyCompletion;
+    private summarize;
+}

package/packages/agent/dist/runtime.js

@@ -0,0 +1,265 @@
+import { ContextEngine, heuristicCheckpoint } from '@ineedcodes/core';
+/**
+ * The real iterative agent loop (plan §7):
+ * reason → tool call → observe actual result → update state → repeat → verify.
+ */
+export class AgentRuntime {
+    services;
+    emit;
+    requestApproval;
+    signal;
+    engine;
+    constructor(services, emit, requestApproval, initialMessages = [], signal) {
+        this.services = services;
+        this.emit = emit;
+        this.requestApproval = requestApproval;
+        this.signal = signal;
+        this.engine = new ContextEngine(services.provider.contextLimit);
+        this.engine.setMessages(initialMessages);
+        if (this.engine.messages.length === 0 || this.engine.messages[0]?.role !== 'system') {
+            this.engine.append({ role: 'system', content: services.systemPrompt });
+        }
+    }
+    get messages() {
+        return this.engine.messages;
+    }
+    async run(objective) {
+        const { provider, registry, toolContext } = this.services;
+        this.engine.append({ role: 'user', content: objective });
+        let turns = 0;
+        let toolCalls = 0;
+        while (turns < this.services.maxTurns) {
+            if (this.signal?.aborted) {
+                return { stopReason: 'aborted', finalMessage: 'Run was cancelled.', turns, toolCalls };
+            }
+            turns += 1;
+            await this.emit({ type: 'turn-start', turn: turns });
+            if (this.engine.needsCompaction()) {
+                const checkpoint = await this.engine.compact(async (msgs) => await this.summarize(msgs));
+                await this.emit({ type: 'compaction', checkpoint });
+            }
+            let response;
+            try {
+                response = await provider.complete({
+                    messages: [...this.engine.messages],
+                    tools: registry.schemas(),
+                    signal: this.signal,
+                    reasoningEffort: this.services.reasoningEffort
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                await this.emit({ type: 'assistant-message', text: `I hit a provider error: ${message}` });
+                return { stopReason: 'error', finalMessage: message, turns, toolCalls };
+            }
+            if (response.toolCalls.length === 0) {
+                // No tool calls: the model believes it is done. Do NOT display this yet :
+                // ask it once to either present evidence (final answer) or keep working,
+                // so the user sees exactly one final answer, never a duplicate.
+                this.engine.append({ role: 'assistant', content: response.content ?? '' });
+                const verdict = await this.verifyCompletion(response.content ?? '');
+                return {
+                    stopReason: verdict.stopReason,
+                    finalMessage: verdict.message || (response.content ?? ''),
+                    turns,
+                    toolCalls
+                };
+            }
+            if (response.content) {
+                await this.emit({ type: 'assistant-message', text: response.content });
+            }
+            this.engine.append({
+                role: 'assistant',
+                content: response.content ?? null,
+                toolCalls: response.toolCalls
+            });
+            let deniedAny = false;
+            for (const call of response.toolCalls) {
+                if (this.signal?.aborted)
+                    break;
+                toolCalls += 1;
+                let input;
+                try {
+                    input = JSON.parse(call.arguments || '{}');
+                }
+                catch {
+                    input = {};
+                }
+                if (call.name === 'get_skill') {
+                    await this.emit({ type: 'skill-invoked', name: String(input?.['name'] ?? '?') });
+                }
+                await this.emit({ type: 'tool-start', tool: call.name, input });
+                // Plan mode: only read-only tools may run; anything else is refused.
+                const tool = registry.get(call.name);
+                if (this.services.mode === 'plan' && tool && !tool.readonly) {
+                    deniedAny = true;
+                    const reason = 'Plan mode is ON: I can only look, not change anything. Switch to build mode (/mode build or Shift+Tab) to apply changes.';
+                    await this.emit({ type: 'permission-denied', tool: call.name, reason });
+                    this.engine.append({
+                        role: 'tool',
+                        content: JSON.stringify({ ok: false, summary: reason, error: 'plan_mode_blocked' }),
+                        toolCallId: call.id,
+                        name: call.name
+                    });
+                    continue;
+                }
+                const permissions = toolContext.permissions;
+                let result;
+                if (!tool) {
+                    result = { ok: false, summary: `Unknown tool: ${call.name}`, error: 'unknown_tool' };
+                }
+                else {
+                    const decision = await permissions.check(tool.permissions, `tool ${call.name}`);
+                    if (!decision.allowed) {
+                        deniedAny = true;
+                        await this.emit({ type: 'permission-denied', tool: call.name, reason: decision.reason });
+                        result = { ok: false, summary: decision.reason, error: 'permission_denied' };
+                    }
+                    else {
+                        result = await registry.execute(call.name, input, toolContext);
+                    }
+                }
+                await this.emit({ type: 'tool-result', tool: call.name, result });
+                this.engine.append({
+                    role: 'tool',
+                    content: JSON.stringify({ ok: result.ok, summary: result.summary, data: result.data, error: result.error }),
+                    toolCallId: call.id,
+                    name: call.name
+                });
+            }
+            if (deniedAny && this.requestApproval) {
+                const approved = await this.requestApproval({
+                    tool: 'session-permissions',
+                    reason: 'One or more actions were blocked by permissions. Approve them to continue?'
+                });
+                if (!approved) {
+                    await this.emit({ type: 'turn-end', turn: turns, stopReason: 'needs_approval' });
+                    return { stopReason: 'needs_approval', finalMessage: 'Waiting for your approval. Re-run or use /permissions to adjust.', turns, toolCalls };
+                }
+            }
+            await this.emit({ type: 'turn-end', turn: turns, stopReason: 'continue' });
+        }
+        return {
+            stopReason: 'max_turns',
+            finalMessage: 'I reached the execution limit for this run. The work is partially done: ask me to continue.',
+            turns,
+            toolCalls
+        };
+    }
+    /**
+     * Second-chance verification: when the model stops calling tools, require it
+     * to either present evidence of completion or state what is missing.
+     * Returns the single final answer (never duplicated to the UI).
+     */
+    async verifyCompletion(draftAnswer) {
+        const effort = this.services.reasoningEffort ?? 'medium';
+        const mode = this.services.mode;
+        // Plan mode: the answer is an analysis, not an implementation claim: accept it as-is.
+        if (mode === 'plan') {
+            return { stopReason: 'complete', message: draftAnswer };
+        }
+        // LOW effort: speed first: accept the draft, skip the verification round trip.
+        if (effort === 'low') {
+            return { stopReason: 'complete', message: draftAnswer };
+        }
+        // MEDIUM effort: accept the draft when it already presents evidence.
+        // HIGH effort: never trusts the draft: always runs the evidence check below.
+        const looksVerified = /(^|\n)\s*(DONE:|verified|exit code|passed|✓)/i.test(draftAnswer) && draftAnswer.length > 40;
+        if (effort !== 'high' && looksVerified) {
+            return { stopReason: 'complete', message: draftAnswer };
+        }
+        const { provider, registry } = this.services;
+        let response;
+        try {
+            response = await provider.complete({
+                messages: [
+                    ...this.engine.messages,
+                    {
+                        role: 'user',
+                        content: 'Before finishing: state your final answer. If the objective is complete, list the evidence ' +
+                            '(commands run, exit codes, test results). If it is not complete, continue working with tools instead. ' +
+                            'Reply with exactly one line starting with "DONE:" if verified complete, or "BLOCKED:" plus the reason if you cannot continue, or keep using tools.'
+                    }
+                ],
+                tools: registry.schemas(),
+                signal: this.signal,
+                reasoningEffort: this.services.reasoningEffort
+            });
+        }
+        catch {
+            return { stopReason: 'complete', message: draftAnswer };
+        }
+        if (response.toolCalls.length > 0) {
+            // Model wants to keep working; show the draft as narration, run the tools,
+            // and continue the loop. Only one final answer will be displayed at the end.
+            if (response.content) {
+                await this.emit({ type: 'assistant-message', text: response.content });
+            }
+            else if (draftAnswer) {
+                await this.emit({ type: 'thinking', text: draftAnswer });
+            }
+            this.engine.append({ role: 'assistant', content: response.content ?? null, toolCalls: response.toolCalls });
+            for (const call of response.toolCalls) {
+                let input = {};
+                try {
+                    input = JSON.parse(call.arguments || '{}');
+                }
+                catch {
+                    // leave empty
+                }
+                const tool = this.services.registry.get(call.name);
+                let result;
+                if (!tool) {
+                    result = { ok: false, summary: `Unknown tool: ${call.name}`, error: 'unknown_tool' };
+                }
+                else {
+                    const decision = await this.services.toolContext.permissions.check(tool.permissions, `tool ${call.name}`);
+                    result = decision.allowed
+                        ? await this.services.registry.execute(call.name, input, this.services.toolContext)
+                        : { ok: false, summary: decision.reason, error: 'permission_denied' };
+                }
+                await this.emit({ type: 'tool-result', tool: call.name, result });
+                this.engine.append({
+                    role: 'tool',
+                    content: JSON.stringify(result),
+                    toolCallId: call.id,
+                    name: call.name
+                });
+            }
+            const continuation = await this.run('Continue from the tool results above and finish the objective.');
+            return { stopReason: continuation.stopReason, message: continuation.finalMessage };
+        }
+        const text = response.content ?? '';
+        if (text.startsWith('BLOCKED:')) {
+            return { stopReason: 'needs_information', message: text.replace(/^BLOCKED:\s*/, '') };
+        }
+        return { stopReason: 'complete', message: (text || draftAnswer).replace(/^DONE:\s*/, '') };
+    }
+    async summarize(messages) {
+        try {
+            const response = await this.services.provider.complete({
+                reasoningEffort: this.services.reasoningEffort,
+                messages: [
+                    {
+                        role: 'system',
+                        content: 'Summarize this agent session segment into a factual checkpoint. Output strict JSON: ' +
+                            '{"objective": string, "decisions": string[], "unresolved": string[], "recentSummary": string}. ' +
+                            'Facts only, no speculation.'
+                    },
+                    { role: 'user', content: messages.map((m) => `${m.role}: ${(m.content ?? '').slice(0, 500)}`).join('\n').slice(0, 60_000) }
+                ],
+                temperature: 0
+            });
+            if (response.content) {
+                const parsed = JSON.parse(response.content);
+                if (typeof parsed.objective === 'string')
+                    return parsed;
+            }
+        }
+        catch {
+            // fall through to heuristic
+        }
+        return heuristicCheckpoint(messages);
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/packages/agent/dist/runtime.js.map

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

package/packages/agent/dist/system-prompts.d.ts

@@ -0,0 +1,24 @@
+import type { Skill, WorkspaceInfo } from '@ineedcodes/core';
+export type ExplanationDepth = 'beginner' | 'balanced' | 'terse';
+export interface SystemPromptOptions {
+    objective: string;
+    workspace: WorkspaceInfo;
+    skills: Skill[];
+    memories: string[];
+    depth: ExplanationDepth;
+    permissionMode: string;
+    /** plan = read-only analysis; build = full autonomy. */
+    mode?: 'plan' | 'build';
+    reasoningEffort?: 'low' | 'medium' | 'high';
+    isSubAgent?: boolean;
+    capability?: string;
+    parentObjective?: string;
+}
+export declare function buildSystemPrompt(opts: SystemPromptOptions): string;
+export declare function buildTaskPacketPrompt(packet: {
+    objective: string;
+    context: string;
+    constraints: string[];
+    expectedResult: string;
+    workspace: string;
+}): string;

package/packages/agent/dist/system-prompts.js

@@ -0,0 +1,91 @@
+const IDENTITY = `You are iNeedCodes, an autonomous terminal agent.
+The user describes outcomes; you decide how to achieve them. You are not a chatbot that
+generates code: you take real actions: inspect files, search code, run commands, edit
+files, run Git, run tests, use the web, and verify results.
+
+Core rules:
+- NEVER fabricate tool output. Success claims require real evidence (exit codes, test output, build output).
+- Never report success just because generated code looks correct. Run the verification.
+- Prefer targeted patches over full-file rewrites for existing source files.
+- Work inside the current project. Touch files outside it only when the user asked for it.
+- Do not push to remotes, force-push, reset --hard, or delete data without explicit approval.
+- Do not invent configuration, endpoints, or APIs. If something is unavailable, say so plainly.`;
+const BEGINNER_STYLE = `Communication style: the user may be a beginner.
+- Before important actions, say in one short sentence what you are doing and why.
+- When something fails, explain in simple words what went wrong before fixing it.
+- Avoid unexplained jargon. If you must use a technical term, briefly define it.
+- At the end, give a short summary: what changed, what you verified, and one thing the user learned.`;
+const BALANCED_STYLE = `Communication style: concise and informative. Briefly note important actions, report evidence for results.`;
+const TERSE_STYLE = `Communication style: terse. Minimal narration, dense results, no fluff.`;
+const LEAD_DUTIES = `As the Lead Agent you are the authoritative coordinator:
+- Understand the user's real objective before acting.
+- Do simple work directly. Do not spawn sub-agents for small tasks.
+- Spawn sub-agents when parallel research, implementation, testing, or review genuinely helps.
+- Reconcile sub-agent results yourself; they never control the session.
+- Keep going until the objective is verified complete, you need approval, or you truly need information from the user.`;
+const SUB_AGENT_DUTIES = (capability, parentObjective) => `You are a sub-agent (${capability}) created by the Lead Agent.
+The Lead Agent's overall objective: ${parentObjective}
+Your job is ONLY your own task packet. Do not expand scope. Do not commit or push.
+When done, produce a result summary with evidence: what you did, what you verified (commands + exit codes), files changed, and any unresolved issues.`;
+export function buildSystemPrompt(opts) {
+    const ws = opts.workspace;
+    const parts = [IDENTITY];
+    if (opts.isSubAgent) {
+        parts.push(SUB_AGENT_DUTIES(opts.capability ?? 'general', opts.parentObjective ?? opts.objective));
+    }
+    else {
+        parts.push(LEAD_DUTIES);
+    }
+    // Reasoning effort changes HOW the agent thinks, not just a flag:
+    // high = deliberate multi-step reasoning; low = act immediately.
+    if (opts.reasoningEffort === 'high') {
+        parts.push('Thinking depth: HIGH. Before acting: consider root causes, edge cases, and second-order effects. ' +
+            'For multi-step work, plan the steps first, then execute. Before claiming success, actively look for ways ' +
+            'your conclusion could be wrong and check them. Do not skip verification.');
+    }
+    else if (opts.reasoningEffort === 'low') {
+        parts.push('Thinking depth: LOW. Be fast and direct: minimal deliberation, act on the obvious path, keep answers short. ' +
+            'Skip ceremony; if a task turns out to be bigger than it looks, say so and ask.');
+    }
+    if (opts.mode === 'plan') {
+        parts.push('MODE: PLAN (read-only). Analyze, explore, and propose: do NOT modify files, run state-changing commands, ' +
+            'or commit. Produce a concrete, step-by-step plan the user can approve before any change is made.');
+    }
+    parts.push(opts.depth === 'beginner' ? BEGINNER_STYLE
+        : opts.depth === 'terse' ? TERSE_STYLE
+            : BALANCED_STYLE);
+    const env = [
+        `Working directory: ${ws.root}`,
+        `Project root: ${ws.projectRoot}`,
+        ws.isGitRepo ? `Git repository: yes (branch ${ws.gitBranch ?? 'unknown'})` : 'Git repository: no',
+        `Permission mode: ${opts.permissionMode}`
+    ];
+    parts.push(`## Environment\n${env.join('\n')}`);
+    if (ws.projectInstructions) {
+        parts.push(`## Project instructions (apply automatically)\n${ws.projectInstructions}`);
+    }
+    if (opts.memories.length) {
+        parts.push(`## Relevant memory from previous sessions\n${opts.memories.map((m) => `- ${m}`).join('\n')}`);
+    }
+    if (opts.skills.length) {
+        const list = opts.skills
+            .map((s) => `- ${s.name}${s.scope !== 'builtin' ? ` (${s.scope})` : ''}: ${s.description}`)
+            .join('\n');
+        parts.push(`## Available skills\n${list}\n\n` +
+            `Use a skill when the user names it, or when the description clearly matches the task. ` +
+            `To follow a skill, apply its instructions to your next actions (skill text is provided by the get_skill tool).`);
+    }
+    parts.push(`## Current objective\n${opts.objective}`);
+    return parts.join('\n\n');
+}
+export function buildTaskPacketPrompt(packet) {
+    return [
+        `## Task packet`,
+        `Objective: ${packet.objective}`,
+        packet.context ? `Context:\n${packet.context}` : '',
+        packet.constraints.length ? `Constraints:\n- ${packet.constraints.join('\n- ')}` : '',
+        `Expected result: ${packet.expectedResult}`,
+        `Workspace: ${packet.workspace}`
+    ].filter(Boolean).join('\n\n');
+}
+//# sourceMappingURL=system-prompts.js.map

package/packages/agent/dist/system-prompts.js.map

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

package/packages/agent/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@ineedcodes/agent",
+  "version": "0.1.0",
+  "description": "iNeedCodes agent runtime: lead agent, orchestrator, sub-agents, boost",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@ineedcodes/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  }
+}

package/packages/cli/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { redactSecrets, type IneedcodesConfig, type WorkspaceInfo } from '@ineedcodes/core';
+export { redactSecrets, type IneedcodesConfig, type WorkspaceInfo };