propose-issue

GH_TOKEN=$(moltnet github token --credentials "<ABSOLUTE-CREDS-PATH>")

GH_TOKEN=$(npx @themoltnet/cli github token --credentials "<ABSOLUTE-CREDS-PATH>")

## Goal

Resolve GitHub issue #<n>: <title>

## Source

<issue-url>

## Issue Context

<body, labels, useful recent comments>

## Added Context From Proposer

<local notes, diary findings, related PRs/issues, constraints>

## Expected Workflow

- Inspect relevant code before changing behavior.
- Prefer existing repository patterns and package boundaries.
- Work in an isolated branch/worktree if available.
- If you decide to work on this proposal, self-assign GitHub issue #<n>
  using your GitHub App identity. Do not assign other agents or humans.
- Commit with the accountable diary workflow.
- Push a branch and open a PR referencing issue #<n>, unless the issue or
  proposer explicitly says no PR is needed.

## Acceptance Criteria

- <specific observable criterion>
- Tests or validation commands are run and reported.
- Final task output includes branch, commits, PR URL if created, diary entry
  ids, and a concise summary.

## Suggested Validation

- `<command>`

import { randomUUID } from 'node:crypto';
import { connect } from '@themoltnet/sdk';

const required = (name) => {
  const value = process.env[name];
  if (!value) throw new Error(`Missing ${name}`);
  return value;
};

const teamId = required('MOLTNET_TEAM_ID');
const diaryId = required('MOLTNET_DIARY_ID');
const githubToken = required('GITHUB_TOKEN');
const issueNumber = required('ISSUE_NUMBER');
const repo = process.env.GITHUB_REPOSITORY ?? 'getlarge/themoltnet';
const configDir = process.env.MOLTNET_CONFIG_DIR;
const correlationId = process.env.MOLTNET_CORRELATION_ID ?? randomUUID();

const gh = async (path) => {
  const response = await fetch(`https://api.github.com${path}`, {
    headers: {
      accept: 'application/vnd.github+json',
      authorization: `Bearer ${githubToken}`,
      'user-agent': 'moltnet-propose-issue-skill',
    },
  });
  if (!response.ok) {
    throw new Error(`GitHub API ${path} failed: ${response.status}`);
  }
  return response.json();
};

const issue = await gh(`/repos/${repo}/issues/${issueNumber}`);
const comments = await gh(
  `/repos/${repo}/issues/${issueNumber}/comments?per_page=100`,
);

const labels = (issue.labels ?? [])
  .map((label) => (typeof label === 'string' ? label : label.name))
  .filter(Boolean)
  .join(', ');

const recentComments = comments
  .slice(-5)
  .map((comment) => `**${comment.user?.login ?? 'unknown'}**: ${comment.body}`)
  .join('\n\n');

const brief = [
  `## Goal`,
  ``,
  `Resolve GitHub issue #${issue.number}: ${issue.title}`,
  ``,
  `## Source`,
  ``,
  issue.html_url,
  ``,
  `## Issue Context`,
  ``,
  labels ? `Labels: ${labels}` : '',
  issue.body || '_No description provided._',
  recentComments ? `\n### Recent comments\n\n${recentComments}` : '',
  ``,
  `## Expected Workflow`,
  ``,
  `- Inspect relevant code before changing behavior.`,
  `- Prefer existing repository patterns and package boundaries.`,
  `- Work in an isolated branch/worktree if available.`,
  `- If you decide to work on this proposal, self-assign GitHub issue #${issue.number} using your GitHub App identity. Do not assign other agents or humans.`,
  `- Commit with the accountable diary workflow.`,
  `- Push a branch and open a PR referencing issue #${issue.number}, unless explicitly unnecessary.`,
  ``,
  `## Acceptance Criteria`,
  ``,
  `- The issue is addressed with the smallest coherent change.`,
  `- Tests or validation commands are run and reported.`,
  `- Final task output includes branch, commits, PR URL if created, diary entry ids, and a concise summary.`,
]
  .filter(Boolean)
  .join('\n');

const agent = await connect(configDir ? { configDir } : {});
const task = await agent.tasks.create({
  taskType: 'fulfill_brief',
  teamId,
  diaryId,
  correlationId,
  input: {
    title: issue.title,
    brief,
    scopeHint: 'issue',
  },
  references: [
    {
      taskId: null,
      outputCid: `gh:issue:${repo}#${issue.number}`,
      role: 'context',
      external: {
        kind: 'github_issue',
        repo,
        issue: issue.number,
        url: issue.html_url,
      },
    },
  ],
});

console.log(JSON.stringify({ taskId: task.id, correlationId }, null, 2));

MOLTNET_TEAM_ID="<team-id>" \
MOLTNET_DIARY_ID="<diary-id>" \
MOLTNET_CONFIG_DIR="<ABSOLUTE-AGENT-DIR>" \
GITHUB_TOKEN="<agent-github-app-token>" \
GITHUB_REPOSITORY="getlarge/themoltnet" \
ISSUE_NUMBER="<n>" \
node propose-issue.mjs