rhachet-roles-bhuild 0.7.0 → 0.8.3

package/dist/access/daos/daoRadioTask/daoRadioTaskViaGhIssues.d.ts

@@ -0,0 +1,41 @@
+import type { ContextGithubAuth, ContextGitRepo } from '../../../domain.objects/RadioContext';
+import { RadioTask } from '../../../domain.objects/RadioTask';
+import type { RadioTaskRepo } from '../../../domain.objects/RadioTaskRepo';
+import { RadioTaskStatus } from '../../../domain.objects/RadioTaskStatus';
+/**
+ * .what = dao for github issues channel
+ * .why = enables radio task persistence via github issues
+ *
+ * .critical = never use default env's GH_TOKEN; must be explicitly provided
+ */
+export declare const daoRadioTaskViaGhIssues: {
+    get: {
+        one: {
+            byPrimary: (input: {
+                exid: string;
+            }, context: ContextGithubAuth & ContextGitRepo) => Promise<RadioTask | null>;
+            byUnique: (input: {
+                repo: RadioTaskRepo;
+                title: string;
+            }, context: ContextGithubAuth & ContextGitRepo) => Promise<RadioTask | null>;
+        };
+        all: (input: {
+            repo: RadioTaskRepo;
+            filter?: {
+                status?: RadioTaskStatus;
+            };
+            limit?: number;
+        }, context: ContextGithubAuth & ContextGitRepo) => Promise<RadioTask[]>;
+    };
+    set: {
+        findsert: (input: {
+            task: RadioTask;
+        }, context: ContextGithubAuth & ContextGitRepo) => Promise<RadioTask>;
+        upsert: (input: {
+            task: RadioTask;
+        }, context: ContextGithubAuth & ContextGitRepo) => Promise<RadioTask>;
+    };
+    del: (input: {
+        exid: string;
+    }, context: ContextGithubAuth & ContextGitRepo) => Promise<void>;
+};

package/dist/access/daos/daoRadioTask/daoRadioTaskViaGhIssues.js

@@ -0,0 +1,229 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.daoRadioTaskViaGhIssues = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const helpful_errors_1 = require("helpful-errors");
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const util_1 = require("util");
+const RadioTask_1 = require("../../../domain.objects/RadioTask");
+const RadioTaskStatus_1 = require("../../../domain.objects/RadioTaskStatus");
+const composeTaskIntoGhIssues_1 = require("../../../domain.operations/radio/task/format/composeTaskIntoGhIssues");
+const extractTaskFromGhIssues_1 = require("../../../domain.operations/radio/task/format/extractTaskFromGhIssues");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+const writeFileAsync = (0, util_1.promisify)(fs.writeFile);
+const unlinkAsync = (0, util_1.promisify)(fs.unlink);
+/**
+ * .what = convert Date to IsoDateStamp
+ * .why = format date for RadioTask fields
+ */
+const toIsoDateStamp = (date) => {
+    return date.toISOString().split('T')[0];
+};
+/**
+ * .what = run gh cli command and return stdout
+ * .why = wraps exec with proper error handler and explicit token auth
+ *
+ * .critical = never use default env's GH_TOKEN; must be explicitly provided
+ */
+const runGhCommand = async (command, context) => {
+    // strip default env tokens to prevent accidental use
+    const { GH_TOKEN: _removed, GITHUB_TOKEN: _removed2, ...envWithoutToken } = process.env;
+    // build env: explicit token or unset for gh cli session auth
+    const env = context.github.auth.token !== null
+        ? { ...envWithoutToken, GH_TOKEN: context.github.auth.token }
+        : envWithoutToken; // as-human: no GH_TOKEN, use gh cli session
+    const { stdout } = await execAsync(command, { env });
+    return stdout.trim();
+};
+/**
+ * .what = dao for github issues channel
+ * .why = enables radio task persistence via github issues
+ *
+ * .critical = never use default env's GH_TOKEN; must be explicitly provided
+ */
+exports.daoRadioTaskViaGhIssues = {
+    get: {
+        one: {
+            byPrimary: async (input, context) => {
+                const { repo } = context.git;
+                const repoSlug = `${repo.owner}/${repo.name}`;
+                try {
+                    const json = await runGhCommand(`gh issue view ${input.exid} --repo ${repoSlug} --json number,title,body,state,assignees,createdAt,author`, context);
+                    const issue = JSON.parse(json);
+                    // verify this is a radio task
+                    if (!issue.title.startsWith('🎙️ task -')) {
+                        throw new helpful_errors_1.BadRequestError('issue is not a radio task', {
+                            exid: input.exid,
+                            title: issue.title,
+                        });
+                    }
+                    return (0, extractTaskFromGhIssues_1.extractTaskFromGhIssues)({
+                        issueNumber: String(issue.number),
+                        title: issue.title,
+                        body: issue.body,
+                        state: issue.state.toLowerCase(),
+                        assignees: issue.assignees.map((a) => a.login),
+                        repo: repo,
+                        createdAt: toIsoDateStamp(new Date(issue.createdAt)),
+                        createdBy: issue.author.login,
+                    });
+                }
+                catch (error) {
+                    // exec errors have stderr in the error object
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    const stderr = error?.stderr ?? '';
+                    const fullError = `${errorMessage} ${stderr}`;
+                    if (fullError.includes('Could not resolve'))
+                        return null;
+                    if (fullError.includes('not found'))
+                        return null;
+                    throw error;
+                }
+            },
+            byUnique: async (input, context) => {
+                const { repo } = context.git;
+                const repoSlug = `${repo.owner}/${repo.name}`;
+                const searchTitle = `🎙️ task - ${input.title}`;
+                const json = await runGhCommand(`gh issue list --repo ${repoSlug} --search "${searchTitle} in:title" --state all --json number,title,body,state,assignees,createdAt,author --limit 10`, context);
+                const issues = JSON.parse(json);
+                // find exact match
+                const match = issues.find((issue) => issue.title === searchTitle);
+                if (!match)
+                    return null;
+                return (0, extractTaskFromGhIssues_1.extractTaskFromGhIssues)({
+                    issueNumber: String(match.number),
+                    title: match.title,
+                    body: match.body,
+                    state: match.state.toLowerCase(),
+                    assignees: match.assignees.map((a) => a.login),
+                    repo: input.repo,
+                    createdAt: toIsoDateStamp(new Date(match.createdAt)),
+                    createdBy: match.author.login,
+                });
+            },
+        },
+        all: async (input, context) => {
+            const { repo } = context.git;
+            const repoSlug = `${repo.owner}/${repo.name}`;
+            const limit = input.limit ?? 100;
+            const stateFlag = input.filter?.status === RadioTaskStatus_1.RadioTaskStatus.DELIVERED
+                ? '--state closed'
+                : '--state all';
+            const json = await runGhCommand(`gh issue list --repo ${repoSlug} --search "🎙️ task - in:title" ${stateFlag} --json number,title,body,state,assignees,createdAt,author --limit ${limit}`, context);
+            const issues = JSON.parse(json);
+            const tasks = issues
+                .filter((issue) => issue.title.startsWith('🎙️ task -'))
+                .map((issue) => (0, extractTaskFromGhIssues_1.extractTaskFromGhIssues)({
+                issueNumber: String(issue.number),
+                title: issue.title,
+                body: issue.body,
+                state: issue.state.toLowerCase(),
+                assignees: issue.assignees.map((a) => a.login),
+                repo: input.repo,
+                createdAt: toIsoDateStamp(new Date(issue.createdAt)),
+                createdBy: issue.author.login,
+            }));
+            // filter by status if specified
+            if (input.filter?.status) {
+                return tasks.filter((task) => task.status === input.filter.status);
+            }
+            return tasks;
+        },
+    },
+    set: {
+        findsert: async (input, context) => {
+            const { repo } = context.git;
+            const repoSlug = `${repo.owner}/${repo.name}`;
+            // check if task already exists
+            const taskFound = await exports.daoRadioTaskViaGhIssues.get.one.byUnique({ repo: input.task.repo, title: input.task.title }, context);
+            if (taskFound)
+                return taskFound;
+            // create new issue
+            const { title, body } = (0, composeTaskIntoGhIssues_1.composeTaskIntoGhIssues)({ task: input.task });
+            // write body to temp file to preserve newlines
+            const tempFile = path.join(os.tmpdir(), `radio-task-${Date.now()}.md`);
+            await writeFileAsync(tempFile, body);
+            try {
+                const output = await runGhCommand(`gh issue create --repo ${repoSlug} --title "${title.replace(/"/g, '\\"')}" --body-file "${tempFile}"`, context);
+                // parse issue number from URL output (e.g., "https://github.com/owner/repo/issues/123")
+                const issueNumberMatch = output.match(/\/issues\/(\d+)/);
+                if (!issueNumberMatch)
+                    throw new Error(`failed to parse issue number from: ${output}`);
+                return new RadioTask_1.RadioTask({
+                    ...input.task,
+                    exid: issueNumberMatch[1],
+                });
+            }
+            finally {
+                await unlinkAsync(tempFile).catch(() => { });
+            }
+        },
+        upsert: async (input, context) => {
+            const { repo } = context.git;
+            const repoSlug = `${repo.owner}/${repo.name}`;
+            // check if task exists
+            const taskFound = input.task.exid
+                ? await exports.daoRadioTaskViaGhIssues.get.one.byPrimary({ exid: input.task.exid }, context)
+                : await exports.daoRadioTaskViaGhIssues.get.one.byUnique({ repo: input.task.repo, title: input.task.title }, context);
+            if (!taskFound) {
+                // create new issue
+                return exports.daoRadioTaskViaGhIssues.set.findsert(input, context);
+            }
+            // update issue
+            const { title, body } = (0, composeTaskIntoGhIssues_1.composeTaskIntoGhIssues)({ task: input.task });
+            // write body to temp file to preserve newlines
+            const tempFile = path.join(os.tmpdir(), `radio-task-edit-${Date.now()}.md`);
+            await writeFileAsync(tempFile, body);
+            try {
+                await runGhCommand(`gh issue edit ${taskFound.exid} --repo ${repoSlug} --title "${title.replace(/"/g, '\\"')}" --body-file "${tempFile}"`, context);
+            }
+            finally {
+                await unlinkAsync(tempFile).catch(() => { });
+            }
+            // add assignee for CLAIMED status
+            if (input.task.status === RadioTaskStatus_1.RadioTaskStatus.CLAIMED &&
+                input.task.claimedBy) {
+                await runGhCommand(`gh issue edit ${taskFound.exid} --repo ${repoSlug} --add-assignee "${input.task.claimedBy}"`, context);
+            }
+            // close issue for DELIVERED status
+            if (input.task.status === RadioTaskStatus_1.RadioTaskStatus.DELIVERED) {
+                await runGhCommand(`gh issue close ${taskFound.exid} --repo ${repoSlug}`, context);
+            }
+            return new RadioTask_1.RadioTask({
+                ...input.task,
+                exid: taskFound.exid,
+            });
+        },
+    },
+    del: async (input, context) => {
+        const { repo } = context.git;
+        const repoSlug = `${repo.owner}/${repo.name}`;
+        await runGhCommand(`gh issue close ${input.exid} --repo ${repoSlug} --reason "not planned"`, context);
+    },
+};
+//# sourceMappingURL=daoRadioTaskViaGhIssues.js.map

package/dist/access/daos/daoRadioTask/daoRadioTaskViaGhIssues.js.map

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

package/dist/access/daos/daoRadioTask/daoRadioTaskViaOsFileops.d.ts

@@ -0,0 +1,39 @@
+import type { ContextGitRepo } from '../../../domain.objects/RadioContext';
+import { RadioTask } from '../../../domain.objects/RadioTask';
+import type { RadioTaskRepo } from '../../../domain.objects/RadioTaskRepo';
+import { RadioTaskStatus } from '../../../domain.objects/RadioTaskStatus';
+/**
+ * .what = dao for local filesystem channel
+ * .why = enables radio task persistence via filesystem for offline access
+ */
+export declare const daoRadioTaskViaOsFileops: {
+    get: {
+        one: {
+            byPrimary: (input: {
+                exid: string;
+            }, context: ContextGitRepo) => Promise<RadioTask | null>;
+            byUnique: (input: {
+                repo: RadioTaskRepo;
+                title: string;
+            }, context: ContextGitRepo) => Promise<RadioTask | null>;
+        };
+        all: (input: {
+            repo: RadioTaskRepo;
+            filter?: {
+                status?: RadioTaskStatus;
+            };
+            limit?: number;
+        }, context: ContextGitRepo) => Promise<RadioTask[]>;
+    };
+    set: {
+        findsert: (input: {
+            task: RadioTask;
+        }, context: ContextGitRepo) => Promise<RadioTask>;
+        upsert: (input: {
+            task: RadioTask;
+        }, context: ContextGitRepo) => Promise<RadioTask>;
+    };
+    del: (input: {
+        exid: string;
+    }, context: ContextGitRepo) => Promise<void>;
+};

package/dist/access/daos/daoRadioTask/daoRadioTaskViaOsFileops.js

@@ -0,0 +1,243 @@
+"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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.daoRadioTaskViaOsFileops = void 0;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs/promises"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const RadioTask_1 = require("../../../domain.objects/RadioTask");
+const RadioTaskStatus_1 = require("../../../domain.objects/RadioTaskStatus");
+const composeTaskIntoOsFileops_1 = require("../../../domain.operations/radio/task/format/composeTaskIntoOsFileops");
+const extractTaskFromOsFileops_1 = require("../../../domain.operations/radio/task/format/extractTaskFromOsFileops");
+/**
+ * .what = generate a short unique id
+ * .why = create exid for new tasks
+ */
+const genShortId = () => {
+    return crypto.randomUUID().slice(0, 8);
+};
+/**
+ * .what = convert Date to IsoDateStamp
+ * .why = format date for RadioTask fields
+ */
+const toIsoDateStamp = (date) => {
+    return date.toISOString().split('T')[0];
+};
+/**
+ * .what = compute global radio directory path for a repo
+ * .why = consistent path resolution for task storage
+ */
+const getGlobalRadioDir = (repo) => {
+    return path.join(os.homedir(), 'git', '.radio', repo.owner, repo.name);
+};
+/**
+ * .what = compute task file path from exid
+ * .why = consistent file name for task storage
+ */
+const getTaskFilePath = (radioDir, exid) => {
+    return path.join(radioDir, `task.${exid}._.md`);
+};
+/**
+ * .what = compute status flag file path
+ * .why = enables fast status queries via glob
+ */
+const getStatusFlagPath = (radioDir, exid, status) => {
+    return path.join(radioDir, `task.${exid}._.status=${status}.flag`);
+};
+/**
+ * .what = compute backup file path with iso timestamp
+ * .why = preserves prior versions on edit
+ */
+const getBackupFilePath = (radioDir, exid) => {
+    const isoNow = toIsoDateStamp(new Date());
+    return path.join(radioDir, `task.${exid}.bak.${isoNow}.md`);
+};
+/**
+ * .what = check if a path exists
+ * .why = helper for file existence checks
+ */
+const pathExists = async (filePath) => {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * .what = ensure directory exists
+ * .why = bootstrap radio directory structure
+ */
+const ensureDir = async (dirPath) => {
+    await fs.mkdir(dirPath, { recursive: true });
+};
+/**
+ * .what = remove all status flag files for a task
+ * .why = clean up before set of new status
+ */
+const removeStatusFlags = async (radioDir, exid) => {
+    for (const status of Object.values(RadioTaskStatus_1.RadioTaskStatus)) {
+        const flagPath = getStatusFlagPath(radioDir, exid, status);
+        if (await pathExists(flagPath)) {
+            await fs.rm(flagPath);
+        }
+    }
+};
+/**
+ * .what = dao for local filesystem channel
+ * .why = enables radio task persistence via filesystem for offline access
+ */
+exports.daoRadioTaskViaOsFileops = {
+    get: {
+        one: {
+            byPrimary: async (input, context) => {
+                const radioDir = getGlobalRadioDir(context.git.repo);
+                const filePath = getTaskFilePath(radioDir, input.exid);
+                if (!(await pathExists(filePath)))
+                    return null;
+                const content = await fs.readFile(filePath, 'utf-8');
+                return (0, extractTaskFromOsFileops_1.extractTaskFromOsFileops)({ content });
+            },
+            byUnique: async (input, context) => {
+                const radioDir = getGlobalRadioDir(context.git.repo);
+                // list all task files and find by title
+                if (!(await pathExists(radioDir)))
+                    return null;
+                const files = await fs.readdir(radioDir);
+                const taskFiles = files.filter((f) => f.startsWith('task.') && f.endsWith('._.md'));
+                for (const file of taskFiles) {
+                    const filePath = path.join(radioDir, file);
+                    const content = await fs.readFile(filePath, 'utf-8');
+                    const task = (0, extractTaskFromOsFileops_1.extractTaskFromOsFileops)({ content });
+                    if (task.title === input.title)
+                        return task;
+                }
+                return null;
+            },
+        },
+        all: async (input, context) => {
+            const radioDir = getGlobalRadioDir(context.git.repo);
+            const limit = input.limit ?? 100;
+            if (!(await pathExists(radioDir)))
+                return [];
+            const files = await fs.readdir(radioDir);
+            // if filter by status, use flag files for fast query
+            if (input.filter?.status) {
+                const flagPattern = `._.status=${input.filter.status}.flag`;
+                const flagFiles = files.filter((f) => f.endsWith(flagPattern));
+                const tasks = [];
+                for (const flagFile of flagFiles.slice(0, limit)) {
+                    const exid = flagFile.replace('task.', '').replace(flagPattern, '');
+                    const filePath = getTaskFilePath(radioDir, exid);
+                    if (await pathExists(filePath)) {
+                        const content = await fs.readFile(filePath, 'utf-8');
+                        tasks.push((0, extractTaskFromOsFileops_1.extractTaskFromOsFileops)({ content }));
+                    }
+                }
+                return tasks;
+            }
+            // no filter, read all task files
+            const taskFiles = files.filter((f) => f.startsWith('task.') && f.endsWith('._.md'));
+            const tasks = [];
+            for (const file of taskFiles.slice(0, limit)) {
+                const filePath = path.join(radioDir, file);
+                const content = await fs.readFile(filePath, 'utf-8');
+                tasks.push((0, extractTaskFromOsFileops_1.extractTaskFromOsFileops)({ content }));
+            }
+            return tasks;
+        },
+    },
+    set: {
+        findsert: async (input, context) => {
+            const radioDir = getGlobalRadioDir(context.git.repo);
+            // check if task already exists
+            const taskFound = await exports.daoRadioTaskViaOsFileops.get.one.byUnique({ repo: input.task.repo, title: input.task.title }, context);
+            if (taskFound)
+                return taskFound;
+            // ensure directory exists
+            await ensureDir(radioDir);
+            // generate exid if not provided
+            const exid = input.task.exid || genShortId();
+            const taskWithExid = new RadioTask_1.RadioTask({ ...input.task, exid });
+            // write task file
+            const filePath = getTaskFilePath(radioDir, exid);
+            const content = (0, composeTaskIntoOsFileops_1.composeTaskIntoOsFileops)({ task: taskWithExid });
+            await fs.writeFile(filePath, content, 'utf-8');
+            // write status flag
+            if (taskWithExid.status !== RadioTaskStatus_1.RadioTaskStatus.DELIVERED) {
+                const flagPath = getStatusFlagPath(radioDir, exid, taskWithExid.status);
+                await fs.writeFile(flagPath, '', 'utf-8');
+            }
+            return taskWithExid;
+        },
+        upsert: async (input, context) => {
+            const radioDir = getGlobalRadioDir(context.git.repo);
+            // check if task exists
+            const taskFound = input.task.exid
+                ? await exports.daoRadioTaskViaOsFileops.get.one.byPrimary({ exid: input.task.exid }, context)
+                : await exports.daoRadioTaskViaOsFileops.get.one.byUnique({ repo: input.task.repo, title: input.task.title }, context);
+            if (!taskFound) {
+                // create new task
+                return exports.daoRadioTaskViaOsFileops.set.findsert(input, context);
+            }
+            // ensure directory exists
+            await ensureDir(radioDir);
+            const exid = taskFound.exid;
+            // create backup before overwrite
+            const taskFilePath = getTaskFilePath(radioDir, exid);
+            if (await pathExists(taskFilePath)) {
+                const backupPath = getBackupFilePath(radioDir, exid);
+                await fs.copyFile(taskFilePath, backupPath);
+            }
+            // merge with found task
+            const taskMerged = new RadioTask_1.RadioTask({
+                ...taskFound,
+                ...input.task,
+                exid,
+            });
+            // write task file
+            const content = (0, composeTaskIntoOsFileops_1.composeTaskIntoOsFileops)({ task: taskMerged });
+            await fs.writeFile(taskFilePath, content, 'utf-8');
+            // update status flag
+            await removeStatusFlags(radioDir, exid);
+            if (taskMerged.status !== RadioTaskStatus_1.RadioTaskStatus.DELIVERED) {
+                const flagPath = getStatusFlagPath(radioDir, exid, taskMerged.status);
+                await fs.writeFile(flagPath, '', 'utf-8');
+            }
+            return taskMerged;
+        },
+    },
+    del: async (input, context) => {
+        const radioDir = getGlobalRadioDir(context.git.repo);
+        const filePath = getTaskFilePath(radioDir, input.exid);
+        if (await pathExists(filePath)) {
+            await fs.rm(filePath);
+        }
+        await removeStatusFlags(radioDir, input.exid);
+    },
+};
+//# sourceMappingURL=daoRadioTaskViaOsFileops.js.map

package/dist/access/daos/daoRadioTask/daoRadioTaskViaOsFileops.js.map

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

package/dist/access/daos/daoRadioTask/index.d.ts

@@ -0,0 +1,13 @@
+import type { RadioChannel } from '../../../domain.objects/RadioChannel';
+import { type ContextGithubAuth, type ContextGitRepo, isContextGithubAuth } from '../../../domain.objects/RadioContext';
+import { daoRadioTaskViaGhIssues } from './daoRadioTaskViaGhIssues';
+import { daoRadioTaskViaOsFileops } from './daoRadioTaskViaOsFileops';
+export { daoRadioTaskViaGhIssues, daoRadioTaskViaOsFileops, isContextGithubAuth, };
+export type { ContextGithubAuth, ContextGitRepo };
+/**
+ * .what = generic context type that requires auth based on channel
+ * .why = enables type-safe context requirements per channel
+ *
+ * .critical = GH_ISSUES requires ContextGithubAuth; OS_FILEOPS only needs ContextGitRepo
+ */
+export type ContextDispatchRadio<TChannel extends RadioChannel> = TChannel extends RadioChannel.GH_ISSUES ? ContextGithubAuth & ContextGitRepo : ContextGitRepo;

package/dist/access/daos/daoRadioTask/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isContextGithubAuth = exports.daoRadioTaskViaOsFileops = exports.daoRadioTaskViaGhIssues = void 0;
+const RadioContext_1 = require("../../../domain.objects/RadioContext");
+Object.defineProperty(exports, "isContextGithubAuth", { enumerable: true, get: function () { return RadioContext_1.isContextGithubAuth; } });
+const daoRadioTaskViaGhIssues_1 = require("./daoRadioTaskViaGhIssues");
+Object.defineProperty(exports, "daoRadioTaskViaGhIssues", { enumerable: true, get: function () { return daoRadioTaskViaGhIssues_1.daoRadioTaskViaGhIssues; } });
+const daoRadioTaskViaOsFileops_1 = require("./daoRadioTaskViaOsFileops");
+Object.defineProperty(exports, "daoRadioTaskViaOsFileops", { enumerable: true, get: function () { return daoRadioTaskViaOsFileops_1.daoRadioTaskViaOsFileops; } });
+//# sourceMappingURL=index.js.map

package/dist/access/daos/daoRadioTask/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/access/daos/daoRadioTask/index.ts"],"names":[],"mappings":";;;AACA,uEAI8C;AAO5C,oGARA,kCAAmB,OAQA;AANrB,uEAAoE;AAIlE,wGAJO,iDAAuB,OAIP;AAHzB,yEAAsE;AAIpE,yGAJO,mDAAwB,OAIP"}

package/dist/contract/cli/give.feedback.d.ts

@@ -1,18 +1,20 @@
 /**
- * .what = create a feedback file for a behavior artifact
+ * .what = create or find a feedback file for a behavior artifact
  *
  * .why  = enables structured feedback on any behavior artifact
  *         with placeholder substitution and version support
  *
  * usage:
- *   give.feedback.sh --against <name>   # create feedback for artifact
+ *   give.feedback.sh --against <name>                     # open latest or create v1
  *   give.feedback.sh --against <name> --behavior <name>   # explicit behavior
- *   give.feedback.sh --against <name> --version 2   # create v2 feedback
+ *   give.feedback.sh --against <name> --version 2         # open or create v2
+ *   give.feedback.sh --against <name> --version ++        # create next version
+ *   give.feedback.sh --against <name> --open codium       # open in editor
  *   give.feedback.sh --against <name> --template <path>   # custom template
  *
  * guarantee:
  *   - fail-fast if artifact not found
- *   - fail-fast if feedback file already exists
  *   - fail-fast if template not found
+ *   - findsert: if feedback exists, open it
  */
 export declare const giveFeedback: () => void;